home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-12 / mta_vf30.zip / MTADOCEN.DOC < prev    next >
Text File  |  1992-11-14  |  431KB  |  8,223 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTA       Make Them Anything                  │    D.I.S.P.     │────┐
  3. ║           Convert Compressed                  │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1992  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.30                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: 14th November 1992                  │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTA.EXE / MTM.EXE                           |    └─────────────────┘
  12. ║ │ MTL.EXE / MTZ.EXE                           |       ┌─────┐        |
  13. ║ │ MTA.CTL / MTA.CHx                           |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ MTAOVR.EXE / MTAOVR.OVR (*)                 |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │ Lines starting with '│' are                       └─────────┘
  18. ║ │ changes to release 15.21
  19. ║ │
  20. ║ │
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28. ╔═══════════════════════ (*) OVERLAY FILES ════════════════════════════╗
  29. ║ MTAOVR.EXE and MTAOVR.OVR are files that make the overlayed version  ║
  30. ║ of MTA. These files are available in a separate package which can be ║
  31. ║ found under the name MTAOVvvv.eee (where vvv has the same number as  ║
  32. ║ the last 3 digits of this archive (e.g. F10, F11, F32) and eee is    ║
  33. ║ the extension.                                                       ║
  34. ╚══════════════════════════════════════════════════════════════════════╝
  35.  
  36. ╔══════════════════════════════════════════════════════════════════════╗
  37. ║ READ THE MTA.NEW DOCUMENTATION, THERE ARE SOME CHANGES IN PARAMETERS ║
  38. ║ AND OPTIONS !                                                        ║
  39. ╚══════════════════════════════════════════════════════════════════════╝
  40.  
  41.  ┌───────┬─────────────────────────────────────────────────────────────┐
  42.  │   0   │ Table of contents                                           │
  43.  └───────┴─────────────────────────────────────────────────────────────┘
  44.  
  45.  1 ----    General information
  46.   1.1      Copyrights and License Agreement
  47.   1.2      Newer versions and contacting the author
  48.  
  49.  2 ----    Package description and requirements
  50.   2.1      Preface
  51.   2.2      Requirements
  52.   2.3      Included files
  53.   2.4      History
  54.  
  55.  3 ----    Installation description
  56.   3.1      Installation
  57.    3.1.1   Installation of the software
  58.    3.1.2   The overlay mechanism
  59.   3.2      Archivers
  60.    3.2.1   General remarks and suggestions on archivers
  61.    3.2.2   Remarks on ARC
  62.    3.2.3   Remarks on PAK
  63.    3.2.4   Remarks on ZIP
  64.    3.2.5   Remarks on PKPAK/PKUNPAK
  65.    3.2.6   Remarks on DWC
  66.    3.2.7   Remarks on ZOO
  67.    3.2.8   Remarks on LHarc
  68.    3.2.9   Remarks on LArc
  69.    3.2.10  Remarks on MD
  70.    3.2.11  Remarks on ARJ
  71.    3.2.12  Remarks on HYPER
  72.    3.2.13  Remarks on PKLITE
  73.    3.2.14  Remarks on GIFLITE
  74.    3.2.15  Remarks on JPEG
  75.    3.2.16  Remarks on GIFTEST
  76.    3.2.17  Remarks on SQZ
  77.   3.3      MTA.CTL
  78.    3.3.1   Basic statements
  79.    3.3.2   Statements that define the environment that MTA uses (paths)
  80.    3.3.3   Statements that define the logging
  81.    3.3.4   Statements that define the selection of files
  82.    3.3.5   Statements that define the resulting files
  83.    3.3.6   Your own (new) compressor
  84.    3.3.7   Statements that define the various exits (hooks) in MTA
  85.    3.3.8   Statements that are useful to Bulletin Board Systems/SysOp's
  86.    3.3.9   Special statements
  87.    3.3.10  Statements available when using a registered version
  88.   3.4      Diskette option
  89.   3.5      KeyBoard control
  90.   3.6      Running multiple copies of MTA at the same time
  91.   3.7      Compression of single executable files (PKLITE)
  92.   3.8      The MTA tag-window
  93.   3.9      MTA and unattended operations
  94.   3.10     TICK-files and related material
  95.   3.11     FES, yet another TICK-clone ?
  96.   3.12     Special ARC considerations
  97.   3.13     Using newer versions of archivers
  98.   3.14     Lo-tek functions, calling MTA as shell of MTA
  99.   3.15     TEC files
  100.  
  101.  4 ----    Run-time information
  102.   4.1      Command-line parameters
  103.    4.1.1   Command-line parameters that stand on their own
  104.    4.1.2   Command-line parameters that overrule/toggle/disable MTA.CTL
  105.    4.1.3   Command-line parameters with a special usage
  106.   4.2      Aborting MTA
  107.   4.3      LOG file
  108.   4.4      Errors
  109.  
  110.  5 ----    Version information and credits
  111.   5.1      The BETA-team
  112.   5.2      Credits
  113.   5.3      Version history
  114.   5.4      Copyright, Trademarks
  115.  
  116.  ┌───────┬─────────────────────────────────────────────────────────────┐
  117.  │   1   │ General information                                         │
  118.  └───────┴─────────────────────────────────────────────────────────────┘
  119.  
  120.  1.1 Copyrights and License Agreement
  121.  ────────────────────────────────────
  122.  
  123.  - Users of the MTA-package must accept this disclaimer of warranty:
  124.  
  125.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  126.    warranties, expressed or implied, including, without limitation,  the
  127.    warranties of merchantability  and of fitness  for any purpose.   The
  128.    author assumes  no liability  for damages,  direct or  consequential,
  129.    which may result from the use of the MTA-package;
  130.  
  131.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  132.    charge to the user for evaluation.   Feel free to share it with  your
  133.    friends,  but  please  do  not  give  it  away  altered or as part of
  134.    another  system.   The  essence  of  "user-supported"  software is to
  135.    provide personal  computer users  with quality  software without high
  136.    prices, and yet to provide  incentive for programmers to continue  to
  137.    develop new products.
  138.  
  139.  - If  you find  this program  useful and  find that  you are  using and
  140.    continue the  use of  the MTA-package  after a  30 days trial period,
  141.    you must register the MTA-package as described below;
  142.  
  143.  - Non-commercial can get a license for the usage up to this release  of
  144.    the MTA-package for  a small amount  of money. Look  into the details
  145.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  146.    reduction to upgrade to the  newer versions. These users should  look
  147.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  148.    a POSSIBILITY to submit to one of the special contracts as  explained
  149.    in the file REGISTER.MTA.
  150.  
  151.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  152.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  153.    direct to the  SysOp to get  full access) is  has to pay  more than a
  154.    Non-commercial  user.  Both  types  of  users  should  look  into the
  155.    details in REGISTER.MTA;
  156.  
  157.  - The registration of the MTA-package will license ONE copy for use  on
  158.    any computer at any  one time, as long  as the usage confirms  to the
  159.    type of registration you have done (so NON-commercial usage when  you
  160.    have a non-commercial license);
  161.  
  162.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  163.    must  first   contact  the   Author   at   the  address   above   for
  164.    authorization.
  165.  
  166.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  167.    your friends  for  evaluation.   Please  encourage  them to  register
  168.    their copy if they find that they can use it;
  169.  
  170.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  171.    available  by  means  of  written  letters  or by entering the inter-
  172.    national echomail area DISP;
  173.  
  174.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  175.    conference <tm> called DISP (international). Entering this echo  does
  176.    not  exclude  you  of  the  duty  to register the MTA-package, though
  177.    users who evaluate the product can enter the echo for questions;
  178.  
  179.  - The  MTA-package, all  programs, the  documentation and support-files
  180.    is  copyrighted  1990,92  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  181.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  182.    this  package  for  backup  purposes.  Also  you  may  copy and share
  183.    unmodified copies of the whole package, providing that the  copyright
  184.    notice    is    reproduced    and    included    on    all    copies.
  185.    Excluded from this statement  are the support-files written  by other
  186.    authors.  Please  refer  to  the  documentation of these programs for
  187.    copyrights and license agreements;
  188.  
  189.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  190.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  191.    Patching the medium at  places that carry the  software is seen as  a
  192.    program change and is also forbidden. It is forbidden to create a  so
  193.    called 'bypass' to skip the original introduction screens and  delay.
  194.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  195.    author (Robert W. van Hoeven) himself;
  196.  
  197.  - Performing  any  of  the  illegal  actions as stated in the previous
  198.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  199.    important, to the registered users;
  200.  
  201.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  202.    the WHOLE package  to any archive-system  they like but  all original
  203.    files must  be included  in the  new archive.  The MTA-package on the
  204.    Bulletin Board  can contain  at the  most 2  extra files. These files
  205.    can only be  a commercial for  that Bulletin Board  and/or validation
  206.    data that is presented  as a service to  all users and shall  have no
  207.    other functions;
  208.  
  209.  - After  the normal  trial period  of 30  days, you  must register  the
  210.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  211.  
  212.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  213.    answered as soon I have the time  to do so. You can send me  a letter
  214.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  215.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  216.    Reinier de Groot).  When you want to send me normal mail, address  it
  217.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  218.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  219.    Echomail <tm> area;
  220.  
  221.  
  222.  1.2 Newer versions and contacting the author
  223.  ───────────────────────────────────────────────────────────────────────
  224.  The newest version of  MTA is always available  at the DISP-HQ on  node
  225.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  226.  nodes.  There are three ways of obtaining newer versions of MTA:
  227.  
  228.  
  229.  - Logging on at DISP-HQ or a support node
  230.    Look into the file SUPPORT.MTA for a full list of support nodes;
  231.  
  232.  - Logging on to a SDS node
  233.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  234.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  235.    distribution point in Holland;
  236.  
  237.  - Logging on to your own BBS;
  238.    Chances  are,  that  you  will  find  an older version (international
  239.    users) because it will take some time for the new version to  'bleed'
  240.    thru the net;
  241.  
  242.  - Update service;
  243.    You can enter a special update service (read REGISTER.MTA).
  244.  
  245.  
  246.  If you think you have found problems in MTA, or in any other case,  you
  247.  wish to contact the author, you can send me:
  248.  
  249.  - A letter to the address you can find in the header of this file;
  250.  
  251.  -  A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  252.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  253.  
  254.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  255.  
  256.  ┌───────┬─────────────────────────────────────────────────────────────┐
  257.  │   2   │ Package description and requirements                        │
  258.  └───────┴─────────────────────────────────────────────────────────────┘
  259.  
  260.  2.1 Preface
  261.  ───────────────────────────────────────────────────────────────────────
  262.  MTA is a program that can  be helpful with the job to  convert archives
  263.  (compressed files) from one archive-system (ZIP, ARJ, LZH and such  are
  264.  called archive-systems) to another one.
  265.  
  266.  The   conversion   from   archive-systems    is   something   that   is
  267.  done frequently  on  BBS  systems.  Different  users  do  uploads   for
  268.  files  created  in   various   archive-systems.   The  SysOp    (System
  269.  Operator   of a  BBS) will  make these   files available  in only   one
  270.  system so all  users who  download   one  or  more  files,  only   need
  271.  one archive program to decompress the files.
  272.  
  273.  When  a   normal  user   visits  various   BBS's  that   all have their
  274.  own archive system,   she/he will   also get   a mixture   of different
  275.  files, created in different archive-systems. In this case MTA can  also
  276.  help.
  277.  
  278.  There a tons of features available in MTA. Some of them will only  have
  279.  a meaning for a SysOp, some of  them only for the normal user and  many
  280.  of them for  both. Users can  automatically remove files  from archives
  281.  (many BBS's add  headers and/or files  to the archive  as advertisement
  282.  for the BBS),  SysOp's can add  them, both can  scan for viri  (in many
  283.  different  ways).  There  are  options  to  convert  a  single  file, a
  284.  complete directory (with  or without sub-directories),  complete drives
  285.  and a  special feature  to convert  all files  on a  diskettes from one
  286.  system to another (while the user  won't have to worry that the  target
  287.  files will not fit on the diskette). The list can go on for hours.
  288.  
  289.  The MAJOR   benefit of   MTA is,   that it   treats ANY   of the   most
  290.  known  archivers  with   the  same   service.  Other   programs may  be
  291.  smaller  but only  treat a certain archive-system  for  the full  100%.
  292.  MTA  is  made   in  a   way   that   YOU   can   decide   what   output
  293.  (archive-system)  should  be  created  without   having  to  search for
  294.  better programs  when  you  swap from  one system  to  another. Another
  295.  benefit of  MTA   is the  up-to-date status  of the   program. For more
  296.  than 3  years   now, I  have   managed to  update MTA  at the same time
  297.  (and  sometimes  earlier)  you  got  hold   of  a  new  version of your
  298.  archive-program.  And even when you are  not served within the  minute,
  299.  you  can  always  use  the  special  routines  in MTA  that implement a
  300.  'user-type'  of  archive   program  (based  on  the  extension   of the
  301.  archives).
  302.  
  303.  MTA's documentation  is NOT  easy. It  is a  large text.  There are  so
  304.  many options that can be   useful for you. The   best way to start   is
  305.  to read  everything one  (without   the description  of   the options),
  306.  then  take a ASCII-editor, import chapter   3 and start  to create  the
  307.  configuration  file,  line  by  line,  option  by  option.  If you have
  308.  completed the   setup, you nearly  don't have   to look at  it  anymore
  309.  for a long  time, so take your time.
  310.  
  311.  
  312.  2.2 Requirements
  313.  ───────────────────────────────────────────────────────────────────────
  314.  MTA requires:      - PC XT/AT/386/486 (or more)
  315.                     - At least 400K free memory but it depends on the
  316.                       archiver(s) you use (NON OVERLAYED VERSION);
  317.                     - At least 200K free memory but it depends on the
  318.                       archiver(s) you use (OVERLAYED VERSION);
  319.                     - DOS 3.xx and higher;
  320.                       (tested with 4Dos 4.0, should work with lower
  321.                       versions);
  322.                     - DOS 2.xx ONLY when registered. In this case, a
  323.                       customized version will be created;
  324.                     - HDU optional
  325.                     - Mouse optional
  326.                     - One or more virus-scanners (optional)
  327.                     - The original (de)compression programs. MTA does
  328.                       NOT contain the compression/decompression
  329.                       routines;
  330.                     - The  original  GIF  conversion  programs that are
  331.                       supported by MTA;
  332.  
  333.  
  334.  2.3 Included files
  335.  ───────────────────────────────────────────────────────────────────────
  336.  The package includes : MTA.EXE         The main program
  337.                         MTA.CH1         The chained tag-menu module
  338.                         MTA.CH2         The chained help-menu module
  339.                         MTM.EXE         The maintenance program
  340.                         MTL.EXE         The list program
  341.                         MTA_DIR.EXE     The directory utility
  342.                         MTA_CRC.EXE     The VALIDATE caller
  343.                         MTA__BAT.EXE    A SFX with examples of batches
  344.                         MTA__UTL.EXE    A SFX with additional utilities
  345.  
  346.  Besides this normal and complete package, there is an additional  file,
  347.  containing MTAOVR.EXE and MTA.OVR. These are the files that are  needed
  348.  to run MTA in overlayed mode.
  349.  
  350.  
  351.  
  352.  2.4 History
  353.  ───────────────────────────────────────────────────────────────────────
  354.  MTA is  now 3  years old.  It started  with version  4.01 (first public
  355.  release). Releases 1, 2  and 3 were called  MTZ and could only  convert
  356.  ZIP-files. With  release 13,  MTA changed  from freeware  to shareware.
  357.  With release  14, MTA  added some  extra options  for BBS's  and became
  358.  able to output some of  the text to a modem  (so MTA could be run  as a
  359.  shell under the BBS or a protocol-driver). With release 15, a new  type
  360.  of compressed files is supported.  These are GIF files. Release  15 can
  361.  support  the  conversion  of  GIF  files.  Also,  within  release 15, a
  362.  MS/Windows version of MTA will  be released AND (finally) the  setup of
  363.  the configuration  file will  change from  a ASCII-file  to a  windowed
  364.  (full-screen) setup program  (not in 15.01,  15.01 is a  forced release
  365.  because of the upcoming ZIP 2.xx).
  366.  
  367.  I will try to  keep MTA  as  up-to-date as possible. Every  few  months
  368.  or so, new  versions  of  archive programs   hit the  market. Some   of
  369.  these versions  contain  new   algorithms  and  also  contain   changes
  370.  in the  internal structure.  Up to  now, I   was able  to release a new
  371.  version of MTA only   a few  days  after  the final   release of   such
  372.  versions   (and  sometimes  earlier,  based   on  the   beta-versions).
  373.  Needless to say  that it is a hell of a job to keep informed about  all
  374.  the changed.
  375.  
  376.  ┌───────┬─────────────────────────────────────────────────────────────┐
  377.  │   3   │ Installation description                                    │
  378.  └───────┴─────────────────────────────────────────────────────────────┘
  379.  
  380.  3.1 Installation
  381.  ───────────────────────────────────────────────────────────────────────
  382.  MTA is  not an  easy program  to install.  There are  numerous features
  383.  that can be used.  Also, there are no  specific guidelines for a  quick
  384.  install of the program,  but in the next  chapters I will try  to guide
  385.  you thru the installation in a structured way. Both  new  and  advanced
  386.  users should also take a look at  any  included *.TEC file. These files
  387.  (if present) will give a wider description  of  a  specific topic which
  388.  has caused some questions in the past.
  389.  
  390.  
  391.  3.1.1 Installation of the software
  392.  ───────────────────────────────────────────────────────────────────────
  393.  The first step is  the installation of the  (program) files. This is  a
  394.  very easy step if  you observe all the  following rules. The next steps
  395.  are described with a hard-disk system in mind:
  396.  
  397.  - Decide which directory you want to use. MTA can find its own  support
  398.    files in three possible ways (in the following order):
  399.  
  400.    - In the current directory;
  401.    - The directory containing MTA.EXE (DOS 3.xx and higher only) or any
  402.      other program name if you have renamed  MTA.EXE to something else.
  403.      The same goes for the overlay version;
  404.    - The DOS PATH (DOS 2.xx and higher);
  405.  
  406.    Either use an existing directory or create a new directory that  will
  407.    be used for the  installation of MTA (in  the second case, add  it to
  408.    the DOS PATH,  so the call  to MTA.EXE can  be done from  anywhere on
  409.    the disk);
  410.  
  411.  - Place MTA.EXE, MTA.CH1, MTA.CH2, MTL.EXE, MTM.EXE and MTZ.EXE in  the
  412.    selected directory.  If you  don't want  to use  MTL, MTM and/or MTZ,
  413.    you  can  always   remove  them  later.   MTA.CH1  and  MTA.CH2   are
  414.    (sometimes) needed  by MTA.  MTA.CH1 contains  the interactive  pick-
  415.    list to select files  from a large list,  MTA.CH2 is called when  you
  416.    want help information about  the command-line options. When  you have
  417.    obtained the overlayed version of MTA, you must also copy  MTAOVR.EXE
  418.    and MTAOVR.OVR to the selected directory. All programs CAN be renamed
  419.    to anything you like (e.g.  delete the non-overlayed MTA.EXE and  re-
  420.    name  the  overlayed  MTAOVR.EXE  to  MTA.EXE) but the files MTA.CH1,
  421.    MTA.CH2 can NOT be renamed. Also when you rename the overlay  version
  422.    (MTAOVR.EXE), you must give the  filename-part (not the extension) of
  423.    the overlay file (MTAOVR.OVR) the SAME name (so  rename MTAOVR.EXE to
  424.    BLURB.EXE, in that case, rename MTAOVR.OVR to BLURB.OVR);
  425.  
  426.  - Copy the  included example of  MTA.CTL to the  same directory as  the
  427.    MTA program files. This example file must be changed later on to  you
  428.    own environment and needs. For now, leave it unchanged;
  429.  
  430.  - MTA can  also look for  an environment variable  called MTA. You  can
  431.    add a line  in AUTOEXEC.BAT with  the value 'SET  MTA=[path]' (do not
  432.    code the  quotes and  replace [path]  with the  name of the directory
  433.    where MTA.EXE/CH1/CH2/OVR/CTL are;
  434.  
  435.  - NEVER  use compression  programs like  PKLITE, SHRINK  or DIET on the
  436.    executable files inside  the MTA package.  They must stay  unaltered.
  437.    The programs that are called within MTA (archivers, exits) can,  from
  438.    MTA's point of view, be compressed with these programs. If you insist
  439.    on using the least possible space, you CAN compress  the MTA.CH1/CH2,
  440.    MTL.EXE, MTM.EXE and MTZ.EXE files with PKLITE  or any other program
  441.    that you like;
  442.  
  443.  - Be sure to have the DOS program  SUBST.COM/EXE inside your DOS path.
  444.    This program comes with your release  of  DOS and without them,  MTA
  445.    can do  less of the  conversion  than when  you  have them available.
  446.    As you will see  later, you  need  special  options to set to a value
  447.    to let  MTA make use of this program (so you can still have  them  on
  448.    the drive without MTA using them). Unless  you  have  a special setup
  449.    networks and such), you can rest  assure that you can  use  the SUBST
  450.    program along with MTA, unless you use specialized software that will
  451.    not match with SUBST usage;
  452.  
  453.  - When  installing the  MTA files,  also take  some time  to see  which
  454.    archive programs  you have  where (write  them down,  because you can
  455.    use this  info when  you create  MTA.CTL). Also  take a  look at  the
  456.    versions  you  run  of  these  programs.   The  next chapters will go
  457.    into  specific  details  for  every  supported  archiver.  In case of
  458.    difficulty  or  just  to  stay  up-to-date,  you should try to obtain
  459.    the highest version that is mentioned in the documentation;
  460.  
  461.  - When using the overlayed  version  of  MTA, you  should read the next
  462.    paragraph for more details on how to setup the overlay environment;
  463.  
  464.  
  465.  3.1.2 The overlay mechanism
  466.  ────────────────────────────────────────────────────────────────────────
  467.  There is also an overlay version of MTA. This means  that only part  of
  468.  the code will be active and available in conventional memory (the  part
  469.  of  memory  up  to  640K)  and  the  remaining parts of the code can be
  470.  loaded into  memory when  a certain  part is  needed. Overlays are only
  471.  useful when a program will not  have to access all parts of  the coding
  472.  in  a  short  time.  The  more  coding  is not needed concurrently, the
  473.  bigger the overlay and the smaller the part of conventional memory  the
  474.  program needs.
  475.  
  476.  When a program  is written, the  author will always  try to search  for
  477.  the  best  result  on  a  large  number of implementations, but not all
  478.  situations can be dealt with. Because of these special situations,  MTA
  479.  includes a number of options to make the overlay mechanism as  flexible
  480.  as possible. To change the  overlay mechanism means that you  must know
  481.  how it works by default. When MTA is loaded, it will try to  initialize
  482.  the overlay manager first. This is done in the following manner:
  483.  
  484.  - The program  will search for  the overlay-file. The  location it will
  485.    search is the location where the EXE-file is found. The name must  be
  486.    the same as  the filename-part (without  extension) of the  EXE-file,
  487.    so when you rename MTAOVR.EXE to MTA.EXE, you must  also  rename  the
  488.    MTAOVR.OVR file to TA.OVR. This mechanism works for all  DOS releases
  489.    from version 3.0 and higher. Lower versions of  DOS (1.x and 2.x) can
  490.    not work in  this manner and  you need to  set the location  and name
  491.    overlay-file with help of an environment variable (see later);
  492.  
  493.  - If  the overlay-file  is found,  the program  will initialize  it and
  494.    will examine the memory.  The overlay-manager need some  conventional
  495.    memory  and  it  can  store  the  remaining  part of the overlay (the
  496.    not-active part) in  expanded memory (EMS)  if that is  available and
  497.    contains enough  free memory.  The size  of the  part of conventional
  498.    memory is variable (though it can not  be too small) and is set to  a
  499.    good average  (by default).  The size  of the  part of  EMS memory is
  500.    fixed  for  a  given  release  of  the program. The more conventional
  501.    memory  that  is  assigned  to  the  overlay  buffer,  the better the
  502.    performance  of  the  program  but  the less memory (conventional) is
  503.    available. If the  overlay part can  not be loaded  into EMS (because
  504.    it isn't there or there isn't enough free memory in EMS), it will  be
  505.    left  on  disk  and  parts  of  the  coding  must be loaded from disk
  506.    (slower!) when they are needed;
  507.  
  508.  - If  the overlay-managers  fails to  install the  overlay, the program
  509.    will abort. In general, the failing will be the result of:
  510.  
  511.    - The OVR-file (the overlay) could not be found;
  512.  
  513.    - Not enough conventional memory available to load the overlay;
  514.  
  515.    - Invalid (old) EMS drivers;
  516.  
  517.    - I/O errors on the overlay-file
  518.  
  519.    - Conflicts  between  other  programs  that  use EMS or  conventional
  520.      memory (TSR's, device drivers);
  521.  
  522.  In general, when you do  nothing about the overlay-manager and  you run
  523.  under DOS 3.xx  or higher, you  will have a  solid running program.  If
  524.  you have problems (see above) or  you want to optimize the program  for
  525.  better  thruput,  you  can  (must)  alter the overlay management. These
  526.  changes must be  made with help  of environment variables  (see the DOS
  527.  SET command). Many people asked why you can't put these changes  inside
  528.  the control-file.  That is  not possible,  because the  parsing of  the
  529.  control-file itself is  an overlayed part  of the coding.  You need the
  530.  overlay before you can  access the control file.  That is why you  must
  531.  make use of environment variables. The following environment  variables
  532.  are tested for:
  533.  
  534.  MTAOVROL : This environment variable can  be used to point to the  name
  535.             and/or location of the overlay-file.  You can use it in  two
  536.             ways:
  537.  
  538.             (1) SET MTAOVROL=F:\RAMDRIVE\
  539.             (2) SET MTAOVROL=C:\BBS\PRG\MTA.OVR
  540.  
  541.             In  the  first  case  (1)  you  point  to the directory that
  542.             contains the overlay-file. The  name of the overlay-file  is
  543.             generated from  the program-name  (minus the  extension), so
  544.             when  you  have  MYMTA.EXE,  you  must put MYMTA.OVR in this
  545.             directory  first.  The  directory-name  MUST  end with a '\'
  546.             otherwise the  overlay-manager will  assume RAMDRIVE  as the
  547.             name of the overlay-file and will search for it in F:\.
  548.  
  549.             In the second  case (2) you  point to the  location AND name
  550.             of the overlay-file. In this case the overlay-file can  have
  551.             a  complete  different  name.  So  it  is  valid to call the
  552.             program MTAHELL.EXE  and the  overlay MTAOVR.OVR  if you use
  553.             SET  MTAOVROL=C:\BBS\PRG\MTAOVR.OVR.  This  option  is  also
  554.             needed when you run under DOS 1.xx or 2.xx;
  555.  
  556.             The most  common usage  of this  environment variable  is to
  557.             put  the  overlay-file  on  a  RAM-disk (fast access) and to
  558.             deny the  usage of  EMS for  the overlay  (because you  have
  559.             better candidates for EMS usage).
  560.  
  561.  MTAOVRUE : This environment variable can have 2 values, either Y or  N.
  562.             The program will only test if the value 'N' is used (so  SET
  563.             MTAOVRUE=N). If this is  the case, the overlay  manager will
  564.             not  use  EMS  for  the  overlay-file  and  access  to   the
  565.             overlay-file is done on disk (see MTAOVROL);
  566.  
  567.  MTAOVRBS : This environment  variable can  be used  to alter  (enlarge)
  568.             the  overlay  buffer  in  conventional memory. The program's
  569.             default will give a good  average, but when memory is  not a
  570.             problem  (conventional  memory),  you  can  make the overlay
  571.             buffer bigger and  gain some speed  in the program  thruput.
  572.             To  see  which  value  you  should  set,  you should run the
  573.             program without this option first. Inside the log (you  must
  574.             activate the log),  you can find  the default value  for the
  575.             overlay buffer. You  can make it  smaller but don't  make it
  576.             smaller  than  the  current  size  minus  8192 otherwise the
  577.             overlay-manager  could  fail.  You  can  make  it bigger but
  578.             don't make it too big  (experiment with small steps and  see
  579.             if the  performance gets  better). SET  MTAOVRBS=100000 will
  580.             allocate  100.000  bytes  of  conventional  memory  for  the
  581.             overlay buffer;
  582.  
  583.  MTAOVRPS : This environment  variable can  be used  to alter  (enlarge)
  584.             the 'prohibition area'.  This area is  a part of  the normal
  585.             overlay buffer. It is used to store recently accessed  parts
  586.             of the code. The code  will remain as long as  possible over
  587.             here. If the code is  accessed again, it doesn't have  to be
  588.             loaded from the  overlay-file but can  come from this  area.
  589.             The value you supply with  this variable should not be  less
  590.             than 2. The default  is 3 (buffersize /  3). You can try  to
  591.             gain some speed by making  the overlay buffer larger and  to
  592.             set this  value to  2. The  default gives  a good average in
  593.             combination with most overlay buffers;
  594.  
  595.  In general (DOS version equal or higher than 3.xx, unaltered names  for
  596.  the program-file and overlay-file, enough  EMS memory or a fast  disk),
  597.  you can use the default values and don't have to set these  environment
  598.  variables.
  599.  
  600.  MTA's overlayed version  is available as a separate package (MTAOVxxx).
  601.  It is advised to use the  overlay  version when the remaining memory is
  602.  very low (when running  MTA  under a BBS door like FileDoor <tm>.
  603.  
  604.  
  605.  
  606.  3.2 Archivers
  607.  ───────────────────────────────────────────────────────────────────────
  608.  In the next chapters I will give some personal advise and some  remarks
  609.  on the various archivers that  are available and that MTA  can support.
  610.  If  you  are  an  inexperienced  user,  you can obtain some information
  611.  about archivers you haven't looked at, if you are a pro, you will  find
  612.  some remarks on the  various archivers that have  to deal with the  way
  613.  MTA converts from and to these kind of systems.
  614.  
  615.  
  616.  3.2.1 General remarks and suggestions on archivers
  617.  ───────────────────────────────────────────────────────────────────────
  618.  This  chapter   (3.2.1)  contains   some  PERSONAL   information  about
  619.  archivers in general. If you don't  know all the systems or if  you are
  620.  still in  search for  a better  one, this  chapter can  guide you  in a
  621.  certain way.  I won't start a discussion about the information in  this
  622.  chapter, neither with  the authors (beta-testers)  nor with the  users,
  623.  remember it  is my  personal point  of view,  after looking  at all  of
  624.  them. For starters, I  will URGE to say  that MTA supports ALL  archive
  625.  systems in the  BEST possible way,  so the fact  that I am  not using a
  626.  certain system does  not mean that  MTA does not  support it for  100%.
  627.  Some  other  vendors  supply  conversion  programs  from  all  (or one)
  628.  systems to all  (or one) other  system. Please be  warned that most  of
  629.  these programs ar  written with a  certain archive system  in mind. MTA
  630.  is not such a  program. I neither sell  nor develop any archive  system
  631.  myself  so  MTA  can  look  as  'objective'  as possible to any archive
  632.  system.
  633.  
  634.  The question 'which is the best  archive system for my situation' is  a
  635.  question that is  asked many times.  I can not  give 100% OK  answer to
  636.  this question but I can try. First you must ask yourself one  question.
  637.  WHY, besides  gaining disk  space,   should I  use an  archive program.
  638.  Here are some guidelines:
  639.  
  640.  -a) I  need as  much files  in on  my disks,  so HIGH compression is my
  641.      major goal;
  642.  
  643.  -b) I  want  to  create  compressed  files very quickly because I  have
  644.      either a slow machine or much archives to maintain;
  645.  
  646.  -c) I  want  to  make  my  archives  'transparent'  to  other types of
  647.      operating systems (called 'platforms' with a difficult word);
  648.  
  649.  -d) I need  to archive (and  store) files on  diskette that are  bigger
  650.      than my highest diskette format;
  651.  
  652.  -e) I want  some sort of  version control, so  when I add  a file to an
  653.      archive, any previous file with  the same name inside that  archive
  654.      must be kept as a backup (older level);
  655.  
  656.  I  am  sure  there  are  some  other  guidelines  to follow. For one, I
  657.  personally  like  a  good  and  bug-free  archive  program  with a good
  658.  feedback from users of  vendor when needed. But  let us take the  given
  659.  guidelines (a) to (e) and see what COULD be best for you. In the  given
  660.  order:
  661.  
  662.  -a) Most archivers can  compress to a very  small format but there  are
  663.      three groups  that differ  in size.  The first  group contains  ZIP
  664.      (2.xx),  LZH  (2.xx)  and  ARJ  (2.xx)  in  a random order. It is a
  665.      matter of 1  to 3 percent  depending on the  kind of files.  LZH is
  666.      free (with source-code) which can  be a bonus but also  a drawback.
  667.      The second group  contains ZOO (2.xx),  HYPER (25) and  PAK (2.xx).
  668.      ZOO 2.1x  is somewhere  between the  first and  second group, other
  669.      differ in speed and options. The remaining systems are combined  as
  670.      the third group;
  671.  
  672.  -b) When speed is  the main interest, ZIP  is your goal. LZH  (2.xx) is
  673.      also good and some of the  older systems can work fast. There  is a
  674.      rule that says, the higher  the compression, the more time  it will
  675.      take to  compress. Where  ARJ, ZIP  and LZH  make very com- pressed
  676.      files (within a the 5% bounds), ZIP outruns the others;
  677.  
  678.  -c) If  you want  to make  'portable' archives,  the choices are small.
  679.      Excluding OS/2  and to  my knowledge,  only LZH  and ZOO can create
  680.      transparent archives. ARJ  is working on  one and the  archives are
  681.      already prepared to be transparent;
  682.  
  683.  -d) For  this  feature  you  need  the so called multi-volume  support.
  684.      Only ARJ and ZIP (2.xx) support multi-volume support (MTA does  not
  685.      by the way);
  686.  
  687.  -e) Version  control is  an option  in demand  by programmers.  ARJ and
  688.      ZOO include  version control.  ZOO in  a somewhat  nicer way as ARJ
  689.      but   it  has  just  been  included  in  ARJ,  so there is room for
  690.      improvements;
  691.  
  692.  I think  that most  of the  users need  a combination  of -a)  and -b).
  693.  From the text you  can see that, unless  you need special tricks,  ARJ,
  694.  LZH and  ZIP are  the first  you should  try. If  you love many options
  695.  (and have a fast machine), you should take a look at ARJ.  If you  love
  696.  a good  simple interface  and very  speedy results,  ZIP is  your first
  697.  target and when  you want something  of both (and  the sources, AND  no
  698.  registration), LZH  would be  nice, though  it has  some drawbacks  (no
  699.  path-information, no  multi-volume). I  will skip  to ZIP  2.xx because
  700.  the AV-code is finally possible for non-USA users.
  701.  
  702.  
  703.  3.2.2 Remarks on ARC
  704.  ───────────────────────────────────────────────────────────────────────
  705.  MTA supports : All ARC versions up to 6.02
  706.  
  707.  There are no  special tricks concerning  ARC. When destination  is ARC,
  708.  FULL recursive support  is available if  you use the  SubstDrive option
  709.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  710.  nature of ARC's recursive support.
  711.  
  712.  MTA is  NOT able  to detect  incoming encrypted  ARC-files. There is no
  713.  indication in the ARC whatsoever that an ARC-file is encrypted.  Please
  714.  be careful ! MTA IS able  to unARC encrypted ARC-files when you  supply
  715.  the correct switches to MTA;
  716.  
  717.  If you receive  files from the  newer (7.xx) version  of ARC (SEA)  but
  718.  you don't own ARC  7.xx, you can use  the UNARCPath option in  MTA.EXE.
  719.  This option can point to either ARCE.EXE or XARC.EXE. In that case  you
  720.  can decompress the  files and convert  them to another  system that you
  721.  CAN support.
  722.  
  723.  
  724.  3.2.3 Remarks on PAK
  725.  ───────────────────────────────────────────────────────────────────────
  726.  MTA supports : All PAK versions up to 2.51
  727.  
  728.  There are a  few things to  keep in mind  when using a  PAK version. If
  729.  you still use GSARC (the old PAK),  skip as fast as you can to  a newer
  730.  level (GSARC support will be removed from MTA, somewhere in 1992).
  731.  
  732.  There are some special tricks concerning PAK. When destination is  PAK,
  733.  FULL recursive support  is available if  you use the  SubstDrive option
  734.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  735.  nature of PAK's recursive support.
  736.  
  737.  When adding comments to the PAK file (AutoComment option), up to  64000
  738.  bytes  are  allowed,  although  this  seems  to  be  more  than PAK can
  739.  support.
  740.  
  741.  MTA  is  NOT  able  to  detect  incoming  encrypted  PAK-files, see the
  742.  remarks on ARC files.
  743.  
  744.  NoGate Consulting  have released  a PAK  2.5x with  ZIP-support inside.
  745.  MTA is  NOT able  to use  PAK as  a substitution  for PKWare's ZIP. You
  746.  MUST use PKZIP/PKUNZIP to compress and decompress ZIP files !
  747.  
  748.  
  749.  3.2.4 Remarks on ZIP
  750.  ───────────────────────────────────────────────────────────────────────
  751.  MTA supports : All ZIP versions up to 2.01
  752.  
  753.  When using   ZIP files   (as destination),   you must   remember to set
  754.  the  correct  compression  switches  in   the  ZIPCompression option in
  755.  MTA.CTL.  You can not (of  course) use a switch  that is not  supported
  756.  with your current  version  of  ZIP.   Also  be  sure  to  upgrade   to
  757.  the  highest  possible  version.  MTA  versions  up   to  14.57 contain
  758.  upgrade  support   to  upgrade  from  older   ZIP  (0.xx) to  newer ZIP
  759.  (1.xx)  formats. MTA 15.01 and up  still contain  upgrade support   but
  760.  now  for the   1.xx to  2.xx  versions of ZIP. MTA   will ignore  newer
  761.  ZIP  archives if you still  use an older ZIP version.
  762.  
  763.  MTA  is  able  to  detect  and  process  both  encrypted  ZIP-files and
  764.  ZIP-files  with  Authenticity  Verification  set  to  ON. MTA will skip
  765.  encrypted ZIP-files when no password is supplied to MTA.
  766.  
  767.  From 14.50 and  on, conversion of  volume-labels from and  to ZIP files
  768.  is available in MTA.
  769.  
  770.  
  771.  3.2.5 Remarks on PKPAK/PKUNPAK
  772.  ───────────────────────────────────────────────────────────────────────
  773.  MTA supports : All PKPAK/UNPAK versions up to 3.61
  774.  
  775.  There is  nothing special  in this  support. To  go along  with S.E.A.,
  776.  PKPAK/PKUNPAK  format  is  not  supported  as  destination, nor are the
  777.  (archive) comments inside a PKware created ARC-file;
  778.  
  779.  MTA is NOT able to  detect incoming encrypted PKPAK-files. There  is no
  780.  indication  in  the  ARC  whatsoever  that  a  PKPAK-file is encrypted.
  781.  Please be  careful !  MTA IS  able to  unPAK encrypted PKPAK-files when
  782.  you supply the correct switches to MTA.
  783.  
  784.  
  785.  3.2.6 Remarks on DWC
  786.  ───────────────────────────────────────────────────────────────────────
  787.  MTA supports : DWC version 5.10A
  788.  
  789.  No support for included directories.  You can set the type  of compress
  790.  (average, good) by means of the DWCCompression option in MTA.CTL.
  791.  
  792.  There are some special tricks concerning DWC. When destination is  DWC,
  793.  FULL recursive support  is available if  you use the  SubstDrive option
  794.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  795.  nature of DWC's recursive support.
  796.  
  797.  MTA is able  to detect and  process DWC files  that are encrypted.  MTA
  798.  will skip an encrypted DWC-file when no password is supplied to MTA.
  799.  
  800.  
  801.  3.2.7 Remarks on ZOO
  802.  ───────────────────────────────────────────────────────────────────────
  803.  MTA supports : ZOO version 2.10
  804.  
  805.  There is nothing special in  this support. Full recursive and  relative
  806.  path support is  available. MTA also  supports ZOO 2.01  'extended' and
  807.  the new ZOO 2.10 with very small target files (high compression).
  808.  
  809.  You  can  set  high  compression  for  ZOO  by using the ZOOCompression
  810.  option with a value of h.
  811.  
  812.  When adding comments to the ZOO file (AutoComment option), up to  64000
  813.  bytes  are  allowed,  although  this  seems  to  be  more  than ZOO can
  814.  support.
  815.  
  816.  
  817.  3.2.8 Remarks on LHarc
  818.  ───────────────────────────────────────────────────────────────────────
  819.  MTA supports : All LHarc versions up to 2.13E
  820.  
  821.  There are some special tricks concerning LZH. When using LZH  (in/out),
  822.  FULL recursive support  is available if  you use the  SubstDrive option
  823.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  824.  nature of LZH's recursive support.
  825.  
  826.  NEVER use versions 2.03 to 2.06. Please contact me if you want to  know
  827.  the details WHY MTA can not support these versions.
  828.  
  829.  Remember to set the LZHVersion option to the correct value !!!!!!!!!!
  830.  
  831.  
  832.  3.2.9 Remarks on LArc
  833.  ───────────────────────────────────────────────────────────────────────
  834.  MTA supports : LArc version 3.33
  835.  
  836.  MTA supports  LArc as  it can.  There is  no documentation available to
  837.  me, so everything comes from 'the dark'.
  838.  
  839.  There are some special tricks concerning LZS. When using LZS  (in/out),
  840.  FULL recursive support  is available if  you use the  SubstDrive option
  841.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  842.  nature of LZS's recursive support.
  843.  
  844.  
  845.  3.2.10 Remarks on MD
  846.  ───────────────────────────────────────────────────────────────────────
  847.  MTA supports : MDCD version 1.00
  848.  
  849.  MTA supports MDCD. The  not so commonly used  MDCD program can be  used
  850.  both as source and as  target. Although the sources are  available, MTA
  851.  will use the stand-alone program MDCD.EXE for (de)compression.
  852.  
  853.  
  854.  3.2.11 Remarks on ARJ
  855.  ───────────────────────────────────────────────────────────────────────
  856.  MTA supports : ARJ  version 2.39a (probably also upcomming 2.40)
  857.  
  858.  Support for ARJ is rather straight forward. All standard functions  are
  859.  implemented but at  least ARJ 2.22  is needed because  MTA uses the  -+
  860.  option to switch off the SW_ARJ options.
  861.  
  862.  There is no  support for multi-volumes  and neither for  ARJ files with
  863.  backups  inside.  MTA  can  process  them correctly (even with extended
  864.  testing, see later) but it is up  to you what will happen. You can  set
  865.  the ARJCompression option in MTA to  whatever you like. If you add  the
  866.  -jo  switch,  ARJ  will   decompress  the  backup-versions  along   the
  867.  original, renaming the backup-versions.
  868.  
  869.  ARJ files with a security envelope  are supported but MTA will not  add
  870.  comments or files to these files  as with ZIP (ARJ disallows adding  of
  871.  these objects by reporting an invalid security envelope).
  872.  
  873.  ARJ contains the original  archive-name within the archive  itself. MTA
  874.  can use this  name and (optionally)  rename the source-archive  back to
  875.  that original name before conversion start (OriginalARJName option).
  876.  
  877.  Support for  the 2.10  volume labels  is added.  Please remember to put
  878.  the  KeepVolLabel  (/KEEPVL)  option  on  ONLY  in combination with ARJ
  879.  version 2.1x>. If you use ZIP  (1.1x>) and a lower version of  ARJ than
  880.  2.1x, conversion of the volume-labels  will cause ARJ to abort  and the
  881.  converted files to be moved to the error-directory !
  882.  
  883.  
  884.  3.2.12 Remarks on HYPER
  885.  ───────────────────────────────────────────────────────────────────────
  886.  MTA supports : HYPER version 25 (and up)
  887.  
  888.  This nice little  compression program from  Germany, is also  supported
  889.  in MTA. Testing  (to implement the  protocol in MTA)  gave results that
  890.  are in the same order as LHARC.
  891.  
  892.  MTA support the  recursive features in  HYPER. Any commenting  in a HYP
  893.  file is  impossible (yet)  and thus  not supported  by MTA. All comment
  894.  related features will do nothing on a HYP file.
  895.  
  896.  MTA will support HYPER SFX (self extracting archive) files.
  897.  
  898.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  899.  from or to HYPER and to do maintenance on these files.
  900.  
  901.  
  902.  3.2.13 Remarks on PKLITE
  903.  ───────────────────────────────────────────────────────────────────────
  904.  MTA supports : PKLITE version 1.15 (and up)
  905.  
  906.  It is a little off-topic type of program to be included in MTA, but  it
  907.  is. MTA (and  the selection-menu MTA.CH1)  is changed so  that you easy
  908.  convert  COM/EXE  files  to  compressed  (self-contained) COM/EXE files
  909.  with PKLITE. I think this is a useful bonus (and nothing more) to MTA.
  910.  
  911.  Why not  include LZEXE  you would  ask. The  reasons are  simple (and a
  912.  hint to the author, based on the current version 0.91):
  913.  
  914.  - LZEXE can only directly compress EXE files (COM files need a  special
  915.    conversion); - LZEXE can only go one way;
  916.  
  917.  In the near future I will think about adding the Japanese DIET  program
  918.  into MTA (it can do the same, and more, than PKLITE).
  919.  
  920.  When MTA  works in  (UN)PKLITE mode,  it can  only convert with PKLITE.
  921.  All other files (archives) are not converted.
  922.  
  923.  When MTA  ignores files  in the  selection, there  can be  a number  of
  924.  reasons. These are:
  925.  
  926.  With PKLITE:
  927.  
  928.  - The file is already PKLITE'ed;
  929.  
  930.  - The file is already LZEXE'ed;
  931.  
  932.  - The file is a SFX (Self extracting archive);
  933.  
  934.  With UNPKLITE:
  935.  
  936.  - The file is not PKLITE'ed;
  937.  
  938.  LZEXE files are left, because  it will create problems when  converting
  939.  these programs with PKLITE and when it does NOT create problems,  there
  940.  will be NO gain in size. SFX-files are left for the same reasons.
  941.  
  942.  
  943.  3.2.14 Remarks on GIFLITE
  944.  ───────────────────────────────────────────────────────────────────────
  945.  MTA supports : GIFLITE 1.41 (and up)
  946.  
  947.  With version 15.01,  MTA can also  convert GIF files.  There is support
  948.  for GIFLITE (registered and un-registered) without any drawbacks.
  949.  
  950.  
  951.  3.2.15 Remarks on JPEG
  952.  ───────────────────────────────────────────────────────────────────────
  953.  MTA supports : JPEG 15 (and up)
  954.  
  955.  There are various JPEG implementations. The one from Handmade  Software
  956.  is included for the moment.  The original programs from the  JPEG group
  957.  have reached DISP-HQ to late to be implemented.
  958.  
  959.  
  960.  3.2.16 Remarks on GIFTEST
  961.  ───────────────────────────────────────────────────────────────────────
  962.  MTA supports : GIFTEST 4.0ß
  963.  
  964.  MTA does  not use  any command-line  parameter in  the call to GIFTEST.
  965.  You can add some yourself (using MTA.CTL options and/or a  command-line
  966.  parameter for MTA). MTA is aware of all of the errorlevels that can  be
  967.  returned  by  GIFTEST.  If  you  include  command-line  parameters  for
  968.  GIFTEST that  cause the  GIF-file(s) to  be removed  if they are wrong,
  969.  MTA still try to move the file but without success. The only  'problem'
  970.  in this case, is the warning message you will receive. MTA is aware  of
  971.  all the errorlevels. 5 and 255 are converted to 'decompression  error'.
  972.  When you use  /L on the  GTECOMPRESSION option, be  sure to point  to a
  973.  place  (directory)  that  is  not  'owned'  by  MTA (so NOT the current
  974.  directory).  Use /M to  trigger when the dimensions are  not supported.
  975.  In that case MTA will move the file to the error-directory (lvl 20).
  976.  
  977.  
  978.  3.2.17 Remarks on SQZ
  979.  ───────────────────────────────────────────────────────────────────────
  980.  MTA supports : SQZ version 1.08.2
  981.  
  982.  This is a new compression/decompression program from Sweden. The 1.08.2
  983.  is a BETA test version and should be used with care ! There is  contact
  984.  between the SQZ author (Jonas I Hammarberg) and me, and I will  try  to
  985.  update MTA as soon as possible as there  are  new (changed) versions of
  986.  SQZ that need a change in MTA !
  987.  
  988.  The performance of SQZ is the same or better than ARJ and the new alpha
  989.  of PKZIP (1.93a). The speed  is  somewhere  between ZIP and ARJ, all in
  990.  all it looks very impressive and I have  the intention (if possible) to
  991.  support all functions in SQZ.
  992.  
  993.  MTA does  NOT  support  the  c(omment) option of SQZ because SQZ itself
  994.  (1.08.2) does   not  support  it yet. When  a  new   version  of SQZ is
  995.  released  with this option active, you should not use it in combination
  996.  with MTA 15.21  but  wait  until the explicit support of this option is
  997.  included in  MTA. MTA  is  unable  to  obtain  comments  FROM SQZ files
  998.  (CarryComment 1 and 2  will  work but will use an empty string) but CAN
  999.  add comments to SQZ files.
  1000.  
  1001.  Recursive support is  included  and MTA will always try to compress the
  1002.  files with  the  /p0 switch  (paths 'as-is'). To  use recursive support
  1003.  for source SQZ-files,  the  SUBSTDrive  support  is needed (as with all
  1004.  other archivers).
  1005.  
  1006.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  1007.  from or to HYPER and to do maintenance on these files.
  1008.  
  1009.  
  1010.  3.3 MTA.CTL
  1011.  ───────────────────────────────────────────────────────────────────────
  1012.  To let MTA  work, you must  create a configuration  file where MTA  can
  1013.  obtain  the  information  it  needs.  This  file  is  called MTA.CTL by
  1014.  default but can have any other  name (in which case you must  assign it
  1015.  to MTA by means of  a command-line option or an  environment variable).
  1016.  You can even have more configuration files for different tasks. If  you
  1017.  call the file  MTA.CTL and place  it as described  in chapter 3.1,  MTA
  1018.  will  find  it  without  the  use  of special forces like command-lines
  1019.  and/or  environment  variables.  In  this  DOCUMENTATION  we refer to a
  1020.  configuration file by its  original name (MTA.CTL). You  can substitute
  1021.  your filename in place.
  1022.  
  1023.  The configuration  file is  a normal  ASCII-file (text  file) which you
  1024.  can create and edit with line-editors like EDLIN or EDIT. You can  make
  1025.  the  file  as  big  as  you  want (by inserting many comment-lines) but
  1026.  remember that the size  has a relation with  the speed of reading  when
  1027.  MTA starts.  Large files will take MTA to do longer over the startup.
  1028.  
  1029.  The general formats of options are:
  1030.  
  1031.  OPTION  parameter parameter parameter .... parameter
  1032.  
  1033.  for active options, or:
  1034.  
  1035.  % comment
  1036.  
  1037.  for comments in  the configuration file.  In the documentation  we call
  1038.  the first parameter  'option' and the  secondary parameters are  called
  1039.  'parameter'.  For  parameters,  the  following  syntax  is  used in the
  1040.  description:
  1041.  
  1042.  [.....]   this  parameter is mandatory, it  MUST be present and  have a
  1043.            valid value;
  1044.  
  1045.  {.....}   this  parameter  is   optional.  If  it is NOT present,  some
  1046.            default is used;
  1047.  
  1048.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  1049.            itself UNLESS specified;
  1050.  
  1051.  (*)       If this mark   occurs at the  end of the  options syntax,  it
  1052.            means that this option is  used by other programs in  the MTA
  1053.            package as  well. In  that case  refer to  the bottom  of the
  1054.            description to  see in  which program(s)  the option  is used
  1055.            also;
  1056.  
  1057.  There are  NO restrictions  to the  position you  start the option, nor
  1058.  the  starting  position  of  the  parameters,  but the 'option' and (if
  1059.  present) the  'parameters' have  to be  separated with  at least one or
  1060.  more spaces. You can make any mixture of upper and lower case !
  1061.  
  1062.  Some  of  the  parameters  in  the  MTA.CTL  file can be overruled with
  1063.  command-line switches. A generalized example of MTA.CTL is included  in
  1064.  the release-file. It contains ALL options available in this release.
  1065.  
  1066.  The following chapters will contain the several statements you can  use
  1067.  in MTA.CTL.  In the  documentation, the  statements are  put in logical
  1068.  groups.  These  groups  contain  statements  with  the  same  sort   of
  1069.  functions  or  serve  the  same  group  of  users.  The ACTUAL order of
  1070.  options in the configuration file does not matter at all.
  1071.  
  1072.  
  1073.  3.3.1 Basic statements
  1074.  ───────────────────────────────────────────────────────────────────────
  1075.  The following options are more or less basic options and should be used
  1076.  in any setup. Some of the statements can be left out, because they only
  1077.  add something extra or change the default that MTA itself assumes.
  1078.  
  1079.  ┌─────────────────────────────────────────────────────────────────────┐
  1080.  │ ARCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1081.  │ UNARCPath   [path] {opt} {DynSwapSiz} {second path}                 │
  1082.  │ PAKPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1083.  │ ZOOPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1084.  │ DWCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1085.  │ LZHPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1086.  │ LZSPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1087.  │ PKZIPPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1088.  │ MDPath      [path] {opt} {DynSwapSiz} {second path}                 │
  1089.  │ PKUNZIPPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1090.  │ PKUNPAKPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  1091.  │ ARJPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  1092.  │ HYPERPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  1093.  │ PKLITEPath  [path] {opt} {DynSwapSiz} {second path}                 │
  1094.  │ ZIP2EXEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1095.  │ GIFLITEPath [path] {opt} {DynSwapSiz} {second path}                 │
  1096.  │ GIF2JPGPath [path] {opt} {DynSwapSiz} {second path}                 │
  1097.  │ JPG2GIFPath [path] {opt} {DynSwapSiz} {second path}                 │
  1098.  │ GIFTESTPath [path] {opt} {DynSwapSiz} {second path}                 │
  1099.  └─────────────────────────────────────────────────────────────────────┘
  1100.  Usage : These options point to the various archivers you have installed
  1101.          on your system. If you do not include statements for  archivers
  1102.          that ARE installed AND can  be found in the DOS-path,  MTA will
  1103.          search for them itself, so do not be surprised if, for example,
  1104.          you did not include the ZOOPath option but MTA is still able to
  1105.          work with ZOO files. In that case MTA has found ZOO.EXE in  the
  1106.          DOS-path !  If you  have all  archivers in  the DOS-path, it is
  1107.          still advised to include  the options for these  archivers. MTA
  1108.          will be able to pin-point  the archiver directly in this  case,
  1109.          causing a gain  of speed because,  otherwise, MTA will  start a
  1110.          'quest' for the archiver in the DOS-path.
  1111.  
  1112.          [Path]        This parameter must contain the drive,  directory
  1113.                        and filename  of the  archiver in  question.  MTA
  1114.                        will  validate  if  the  program  is at the given
  1115.                        location  and  terminate  with  an  error  if  it
  1116.                        isn't.
  1117.  
  1118.          {opt}         This  parameter  is optional. You  MUST  code  it
  1119.                        when  one  of  the  following  parameters is used
  1120.                        and/or if  you want  to change  the default. This
  1121.                        parameter  must  have  a  value  of either 'Y' or
  1122.                        'N'. The  value will  decide if  THIS archiver is
  1123.                        going to  be included  when you  want to optimize
  1124.                        your archive  on to  the smallest  size. All  the
  1125.                        archive programs that  do COMPRESSION and  have a
  1126.                        value of 'Y'  will be included  if you force  MTA
  1127.                        to  optimize  on  size  (/OOA on the command-line
  1128.                        or OptimizeOnSize  option in  MTA.CTL set).   'N'
  1129.                        will  cause  MTA  to  skip  this  archiver   when
  1130.                        optimize  is  running.  For  some  archivers  the
  1131.                        value is  not important  because they  either can
  1132.                        not COMPRESS (like PKUNZIP) or they have  nothing
  1133.                        to do with  normal file-compression (GIFLITE  and
  1134.                        such), but if  you code one  or more of  the next
  1135.                        parameters you  still must  include a  'Y' or 'N'
  1136.                        ('N' would be obvious.  'Y' is ignored) for  this
  1137.                        parameter;
  1138.  
  1139.          {DynSwapSiz}  This parameter  will instruct MTA if  swapping is
  1140.                        needed  before  the  (de)compression  program  is
  1141.                        actually  called.  In  previous  releases,   this
  1142.                        parameters was set to a fixed value ('SWAP')  but
  1143.                        with  15.01  and  up,  MTA uses DYNAMIC swapping.
  1144.                        You need to supply  the amount of memory  that is
  1145.                        needed to  run the  specific archive  program. In
  1146.                        the  included  example  of  MTA.CTL,  all minimal
  1147.                        values that worked are  included. If you need  at
  1148.                        least  250K  to  run  a specific archive program,
  1149.                        you must  code '256'  (or higher)  over here. For
  1150.                        some programs it is best to swap ALWAYS. In  this
  1151.                        case  a  value  of  '640'  will  do, because that
  1152.                        amount of CONVENTIONAL memory is NEVER  available
  1153.                        when MTA is running,  causing MTA to always  swap
  1154.                        before the archive  program is called.  With this
  1155.                        option you are more or less save when MTA is  run
  1156.                        from  a  secondary  shell.  Programs that need as
  1157.                        much  memory  as  possible  are  GIG2JPG, JPG2GIF
  1158.                        and, in some cases, ARJ.
  1159.  
  1160.          {second path} MTA (from 15.01)  can use two different sets  (or
  1161.                        versions) of a specific archiver. If you use  the
  1162.                        current PKZIP  and a  newer version  (or even  an
  1163.                        alpha or  beta) is  released, you  normally would
  1164.                        like  to  test  this  archiver  before  you start
  1165.                        using it.  For this  situation, you  can use this
  1166.                        parameter. You can rename your new version to  an
  1167.                        alternate name (f.i. P2ZIP.EXE) or you can  place
  1168.                        it in another directory.  When you have done  so,
  1169.                        you  can  include  the  full  path  to  this  new
  1170.                        program in  this parameter.  Now if  you run  MTA
  1171.                        with  the  /ALT  command-line,  MTA  will use the
  1172.                        program that is coded  over and not the  one that
  1173.                        is coded in the [path] parameter. If there is  no
  1174.                        {second  path}  option  included  but you run MTA
  1175.                        with /ALT, the program in [path] is used;
  1176.  
  1177.          Please notice that you must supply the correct programs to  the
  1178.          above  options.  If  you  replace  one  of  the  program's with
  1179.          another one, strange things  (errors) can occur and  data could
  1180.          corrupt.  Supply the following programs to the options:
  1181.  
  1182.          ARCPath             ARC.EXE     or its alias
  1183.          UNARCPath           XARC.EXE    or its alias (see ARC remarks)
  1184.          PAKPath             PAK.EXE     or its alias
  1185.          ZOOPath             ZOO.EXE     or its alias
  1186.          DWCPath             DWC.EXE     or its alias
  1187.          LZHPath             LHARC.EXE   or its alias
  1188.          LZSPath             LARC.EXE    or its alias
  1189.          PKZIPPath           PKZIP.EXE   or its alias
  1190.          MDPath              MDCD.EXE    or its alias
  1191.          PKUNZIPPath         PKUNZIP.EXE or its alias
  1192.          PKUNPAKPath         PKUNPAK.EXE or its alias
  1193.                           or PKXARC.COM  or its alias
  1194.                           or PKXARC.EXE  or its alias
  1195.          ARJPath             ARJ.EXE     or its alias
  1196.          HYPERPath           HYPER.EXE   or its alias
  1197.          ZIP2EXEPath         ZIP2EXE.EXE or its alias
  1198.          GIFLITEPath         GIFLITE.EXE or its alias
  1199.          JPG2GIFPath         JPG2GIF.EXE or its alias
  1200.          GIF2JPGPath         GIF2JPG.EXE or its alias
  1201.          GIFTESTPath         GIFTEST.EXE or its alias
  1202.  
  1203.          Where 'alias'  is the  name you  renamed the  original file to.
  1204.          Please supply  the complete  drive, directory  and filename  to
  1205.          any of the options !  If you leave the drive  and/or directory,
  1206.          MTA will replace it with the CURRENT drive and/or directory.
  1207.  
  1208.          If you don't own one  or more of the (de)compression  programs,
  1209.          leave out the related option, otherwise MTA will abort !
  1210.  
  1211.  Relate: None
  1212.  Dest. : All
  1213.  (*)   : Marked options are also in usage by: MTM
  1214.  
  1215.  
  1216.  ┌─────────────────────────────────────────────────────────────────────┐
  1217.  │ CompressionType [ttt]                                               │
  1218.  └─────────────────────────────────────────────────────────────────────┘
  1219.  Usage : This option sets the normal TARGET archive system. You can,  at
  1220.          any time,  overrule this  target with  another target.  In that
  1221.          case you can supply the correct command-line to do so.
  1222.  
  1223.          [ttt]          This sets the target. You can supply the  values
  1224.                        'ARC',  'PAK',  'ZIP',  'ZOO', 'LZH' (LHarc/LHA),
  1225.                        'LZS' (Larc), 'DWC',  'HYP', 'ARJ', 'MD'  (MDCD),
  1226.                        'PAKSFX',    'ZIPSFX',    'LZHSFX',     'ARJSFX',
  1227.                        'PKLITE',   'UNPKLITE',   'GIFLITE',   'GIF2JPG',
  1228.                        'JPG2GIF', 'GIF', 'SQZ', 'SQZSFX'  and     'OWN'.
  1229.  
  1230.                        Most of  them look  normal. Some  of them  don't.
  1231.                        The  PAKSFX,  ZIPSFX,  LZHSFX,  SQZSFX and ARJSFX
  1232.                        are the same  as PAK, ZIP,  LZH, SQZ and  ARJ but
  1233.                        also  include  the  creation  of an EXE/COM (SFX)
  1234.                        file.   The  PKLITE  can  be  used to convert EXE
  1235.                        files to PKLITE'ed  EXE files, the  UNPKLITE does
  1236.                        the reversed.   The GIFLITE  will convert  normal
  1237.                        GIF files to GIFLITE  GIF's.  The GIF2JPG  can be
  1238.                        used to convert GIF files to JPG files with  JPEG
  1239.                        and JPG2GIF  does the  reversed.   The value  GIF
  1240.                        will  cause  MTA  to  test  all GIF's (normal and
  1241.                        lite)  with  GIFTEST  (no  conversion, other than
  1242.                        removal of obsolete bytes, will be done).
  1243.  
  1244.                        OWN is  used when  you work  with a  special (not
  1245.                        normally supported  compression program,  see the
  1246.                        OWNxxxx options later on).
  1247.  
  1248.                        When set to  PKLITE/UNPKLITE, MTA will  only look
  1249.                        for  COM/EXE  files  that  can  be  converted  to
  1250.                        PKLITE or that are  converted with PKLITE.   When
  1251.                        set to  GIFLITE, GIF2JPG  or GIF,  MTA will  only
  1252.                        look  for  GIF  files,  when  set to JPG2GIF, MTA
  1253.                        will  only  look  for  files  with  the extension
  1254.                        '.JPG'. All other values  will cause MTA to  look
  1255.                        at all known archives.
  1256.  
  1257.          I suggest that you include  the most frequently used target  in
  1258.          MTA.CTL and use command-line switches to work with the  special
  1259.          ones  (so  set  CompressionType  to  ZIP  if ZIP is your normal
  1260.          target and use /PKLITE on  the command-line to let MTA  work on
  1261.          COM/EXE files when needed).
  1262.  
  1263.  Relate: None
  1264.  Dest. : All
  1265.  
  1266.  
  1267.  ┌─────────────────────────────────────────────────────────────────────┐
  1268.  │ LZHVersion [version] {alt version}                                  │
  1269.  │ PAKVersion [version] {alt version}                               (*)│
  1270.  │ ZIPVersion [version] {alt version}                               (*)│
  1271.  └─────────────────────────────────────────────────────────────────────┘
  1272.  Usage : These options set the version number for the various  archives.
  1273.          They are  needed because  the archivers  involved use different
  1274.          command-lines and/or internal  formats for different  versions.
  1275.          MTA can NOT auto-detect  the version-number (f.i. based  on the
  1276.          length of the  archive program) because  these programs can  be
  1277.          converted with PKLITE, DIET,  LZEXE or some other  EXE-compress
  1278.          program. You  MUST set  the manually  and you  MUST set them to
  1279.          the version you actually use !
  1280.  
  1281.          [version]     Must contain   the right  version. 1.10  must  be
  1282.                        translated to 110, 2.0  to 200, 1.13c to  113 and
  1283.                        so on.
  1284.  
  1285.          {alt version} If you use  the /ALT command-line option and  the
  1286.                        archiver  in  question  has  an alternate version
  1287.                        set  with  {second  path}  in the xxxPath option,
  1288.                        you  must  supply  the  version  number  of  this
  1289.                        program if  it is  not the  same as  the one  you
  1290.                        supplied  in  [version].  So  if  you  use   both
  1291.                        PKZIP.EXE (1.10) and  P2ZIP.EXE (2.01), you  must
  1292.                        code 'ZIPVersion 110 201'.  If you do not  supply
  1293.                        {alt version}, it will  be the same as  the value
  1294.                        set for [version] !
  1295.  
  1296.          Some  notes  about  the  various  differences between versions.
  1297.          For LZH, any value under 200  will cause MTA to give a  warning
  1298.          when a  2.xx archive  is found  (it will  skip the conversion).
  1299.          For ZIP, any value under 200  will cause MTA to give a  warning
  1300.          when a ZIP with a 2.xx format is detected (it will not  convert
  1301.          such a file). For PAK, the difference lies between 000  (GSArc)
  1302.          and 100 and  higher (GSArc does  not return an  errorlevel) and
  1303.          100-199 and 200 and higher (other formats in the PAK files).
  1304.  
  1305.          By default, MTA uses the versions 110 for ZIP, 251 for PAK  and
  1306.          213 for LHarc/LHA.
  1307.  
  1308.  Relate: None
  1309.  Dest. : LZH/PAK/ZIP
  1310.  (*)   : Marked options are also in usage by: MTM
  1311.  
  1312.  
  1313.  ┌─────────────────────────────────────────────────────────────────────┐
  1314.  │ ZIPCompression     [parm..parm]                                  (*)│
  1315.  │ ZSFCompression     [parm..parm]                                     │
  1316.  │ DWCCompression     [parm..parm]                                     │
  1317.  │ ARJCompression     [parm..parm]                                     │
  1318.  │ ASFCompression     [parm..parm]                                     │
  1319.  │ ZOOCompression     [parm..parm]                                     │
  1320.  │ LZHCompression     [parm..parm]                                     │
  1321.  │ LSFCompression     [parm..parm]                                     │
  1322.  │ SQZCompression     [parm..parm]                                     │
  1323.  │ SSFCompression     [parm..parm]                                     │
  1324.  │ PKLITECompression  [parm..parm]                                     │
  1325.  │ GIFLITECompression [parm..parm]                                     │
  1326.  │ G2JCompression     [parm..parm]                                     │
  1327.  │ J2GCompression     [parm..parm]                                     │
  1328.  │ GTECompression     [parm..parm]                                     │
  1329.  └─────────────────────────────────────────────────────────────────────┘
  1330.  Usage : These options can be  used to add some extra parameters  to the
  1331.          compression program. Normally MTA uses the standard  parameters
  1332.          for each program  but some of  the programs can  have alternate
  1333.          parameters to set the density of the compression, the usage  of
  1334.          BIOS/Direct screen calls,  the detail of  reporting and so  on.
  1335.          You can add these options yourself (some suggestions are  given
  1336.          below) by  means of  these statements.  Those archive  programs
  1337.          that are NOT included,  don't have any useful  extra parameters
  1338.          that MTA should pass.
  1339.  
  1340.          [parm..parm]  When  you include the  options, you must  set the
  1341.                        parameters you want to  ADD to the ones  that MTA
  1342.                        already  adds.  You  can  code  them  just as you
  1343.                        would do  when you  called the  program from  the
  1344.                        command-line.
  1345.  
  1346.           The following options can  be used to add  (overrule) command-
  1347.           line parameters to the specific program:
  1348.  
  1349.           ZIPCompression     for PKZIP/PKUNZIP
  1350.           ZSFCompression     for ZIP2EXE
  1351.           DWCCompression     for DWC
  1352.           ARJCompression     for ARJ
  1353.           ASFCompression     for ARJ (when creating SFX files)
  1354.           ZOOCompression     for ZOO
  1355.           LZHCompression     for LZH
  1356.           LSFCompression     for LZH (when creating SFX files)
  1357.           SQZCompression     for SQZ
  1358.           SSFCompression     for SQZ (when creating SFX files)
  1359.           PKLITECompression  for PKLITE
  1360.           GIFLITECompression for GIFLITE
  1361.           G2JCompression     for GIF2JPG
  1362.           J2GCompression     for JPG2GIF
  1363.           GTECompression     for GIFTEST
  1364.  
  1365.          For ZIP you could add -es,  -en or -ex to overrule the  default
  1366.          type of  compression, for  ZOO you  could add  the 'h' for high
  1367.          compression (ZOO 2.1x),  for DWC you  could add the  'y' or 'z'
  1368.          for compression  on speed  or size,  of ARJ  the -jm1 parameter
  1369.          would be  nice and  also the  -jo statement  would be nice when
  1370.          you use  ARJ 2.3x+ and want  to convert any backups  inside the
  1371.          archives  as  well.  For  LHarc  the  /o option would force the
  1372.          older (1.13) method and  so we can go  on for a while.  Be sure
  1373.          to  add  only  extra  parameters.  The obvious ones are already
  1374.          passed by MTA  itself. The parameters  for encrypted files  and
  1375.          for special work  directories (and drives)  are also passed  by
  1376.          MTA, depending on other options !
  1377.  
  1378.  Relate: None
  1379.  Dest  : All
  1380.  (*)   : Marked options are also in usage by: MTM
  1381.  
  1382.  
  1383.  ┌─────────────────────────────────────────────────────────────────────┐
  1384.  │ OriginalARJName                                                     │
  1385.  └─────────────────────────────────────────────────────────────────────┘
  1386.  Usage : ARJ  keeps the name  of the archive  (when created) inside  its
  1387.          own  internal  structure.  Normally  you  would  nor  have  any
  1388.          problem with that, but there are users who rename the ARJ to  a
  1389.          name that fits  their own needs  better. When you  include this
  1390.          option in MTA.CTL, MTA will  FIRST rename the file back  to the
  1391.          ORIGINAL name inside  the ARJ-structure BEFORE  conversion will
  1392.          start. This  could be  useful but  please be  warned that  some
  1393.          third  party  archive-conversion  programs  first  create   the
  1394.          archive with a  temporary name before  renaming it to  the name
  1395.          it should  be. In  such case  a file  DSZ1212.ARJ could also be
  1396.          renamed  back  by  MTA  to  ZIPCONV$.$$$  before the conversion
  1397.          starts. In general, when  you receive files from  others, don't
  1398.          use the option, otherwise you could set it.
  1399.  
  1400.  Relate: None
  1401.  Source: ARJ
  1402.  
  1403.  
  1404.  
  1405.  3.3.2 Statements that define the environment that MTA uses
  1406.  ───────────────────────────────────────────────────────────────────────
  1407.  The following statements  all define a  part of the  actual environment
  1408.  that MTA.EXE will use. Included are statements that define the  several
  1409.  directories that MTA can use,  the minimal requirements for memory  and
  1410.  space on the drives, the swapping functions and so on.
  1411.  
  1412.  ┌─────────────────────────────────────────────────────────────────────┐
  1413.  │ TempPath [dir] {bytfree}                                            │
  1414.  └─────────────────────────────────────────────────────────────────────┘
  1415.  Usage : Most decompressors  can   use an  assigned work-directory.   It
  1416.          can be useful  to point this  work-directory to a  virtual disk
  1417.          (a  so called RAM-disk)  or to  the fastest  medium you   have,
  1418.          but,  in  most   cases,   you   must   sure   that  this  drive
  1419.          (directory) will contain  enough space to  hold  the  temporary
  1420.          work  files  for   the  largest   file   to     convert.   Some
  1421.          archivers   also  use   the environment variable TEMP to   look
  1422.          which directory  can   be used  for temporary   work-space.  In
  1423.          MTA you  can (optionally) assign the temporary directory   that
  1424.          will be  passed  to all  archivers  that can work with  such  a
  1425.          directory. In  most cases,   this will  cause the   archiver to
  1426.          use THIS   directory for   work-space and NOT  the one supplied
  1427.          in   the  variable  TEMP  (if  any).   In  doubt,  consult  the
  1428.          documentation of the archiver in question.
  1429.  
  1430.          [dir]         This value must point to a valid  drive/directory
  1431.                        which can  be used  for temporary  work-space. If
  1432.                        no drive  is supplied,  the default  one is used.
  1433.                        Relative  directories  (..\WRKDIR  and  such) are
  1434.                        not  advised  but  can  be  used (the are counted
  1435.                        from the CURRENT directory).
  1436.  
  1437.          {bytfree}     For  most conversions you need at least  a number
  1438.                        of  bytes  free  on  the  assigned work-directory
  1439.                        (drive).  To  make  sure  that  this  amount   is
  1440.                        present  on  that  drive,  you  can,  optionally,
  1441.                        supply the number of  bytes that must be  free as
  1442.                        the third  parameter. If  the number  of bytes on
  1443.                        the drive is LOWER  than the supplied value,  MTA
  1444.                        will not work and abort with an error. If you  do
  1445.                        not supply  a value,  MTA will  look if  at least
  1446.                        256K bytes  is available,  though that  could not
  1447.                        be enough in  some cases. If  you want to  ignore
  1448.                        the test at all, you can supply a value if 0.
  1449.  
  1450.  Relate: None
  1451.  Dest. : All
  1452.  
  1453.  
  1454.  ┌─────────────────────────────────────────────────────────────────────┐
  1455.  │ MTATempPath [dir] {bytfree}                                         │
  1456.  └─────────────────────────────────────────────────────────────────────┘
  1457.  Usage : For every  archive (and  other object)  that MTA will  convert,
  1458.          MTA creates (and later on removes) a temporary directory  UNDER
  1459.          the current directory. If this  is not what you want  (and this
  1460.          is advised), you must supply this option.
  1461.  
  1462.          [dir]         This value must point to a valid  drive/directory
  1463.                        which can be  used for temporary  directories. If
  1464.                        no drive  is supplied,  the default  one is used.
  1465.                        Relative  directories  (..\WRKDIR  and  such) are
  1466.                        not  advised  but  can  be  used (the are counted
  1467.                        from the  CURRENT directory).  In fact,  relative
  1468.                        directories for this option, are useless in  most
  1469.                        cases.
  1470.  
  1471.          {bytfree}     For  most conversions you need at least  a number
  1472.                        of bytes free on the assigned directory  (drive).
  1473.                        To make sure that this amount is present on  that
  1474.                        drive, you can, optionally, supply the number  of
  1475.                        bytes that must be  free as the third  parameter.
  1476.                        If  the  number  of  bytes  on the drive is LOWER
  1477.                        than the  supplied value,  MTA will  not work and
  1478.                        abort  with  an  error.  If  you  do not supply a
  1479.                        value, MTA will  look if at  least 256K bytes  is
  1480.                        available,  though  that  could  not be enough in
  1481.                        some cases.  If you  want to  ignore the  test at
  1482.                        all, you can supply a value if 0.
  1483.  
  1484.          MTA  will  create  temporary  directories UNDER this directory.
  1485.          The name  is 8  bytes long  (and when  you run  as a  second or
  1486.          third TASK, not child,  they also contain the  task-number) and
  1487.          will  represent  the  HEX  value  of  the  time/date  they were
  1488.          created.  When running as  a child of itself (arc-in-arc),  MTA
  1489.          will create temporary directories  with the name '$'  under the
  1490.          original first (8 byte) temporary directory.
  1491.  
  1492.          Some archivers (DWC as the  most important, related to MTA)  do
  1493.          not like  to see  points inside  a directory-name.  Such a name
  1494.          (f.i. DC33ABAF.1) can ONLY be  the LAST tree from the  root. As
  1495.          an  example,  C:\ZIP\DC33ABAF.1  is   allright  with  DWC   but
  1496.          C:\ZIP.ZIP\DC33ABAF.1 is NOT.
  1497.  
  1498.  Relate: ALTMTATempPath
  1499.  Dest. : All
  1500.  
  1501.  
  1502.  ┌─────────────────────────────────────────────────────────────────────┐
  1503.  │ ALTMTATempPath [dir] {bytfree}                                      │
  1504.  └─────────────────────────────────────────────────────────────────────┘
  1505.  Usage : When you have supplied the MTATemppath option, you can also
  1506.          supply this option. The format and usage of this option is
  1507.          the same as for the MTATempPath option.
  1508.  
  1509.          What is the usage of this option ? You can setup the normal
  1510.          MTATEMPPath option to point to a fast drive (like a RAM-disk).
  1511.          Normally a RAM-disk only contains a limited number of bytes
  1512.          and that can be a problem when big archives are converted.
  1513.          If there is not enough free space on the drive that is pointed
  1514.          to by the MTATempPath option, the archive(s) in question will
  1515.          be skipped.
  1516.  
  1517.          If you supply the ALTMTATempPath (along with the MTATEMPPath)
  1518.          you are out of trouble. IN MTATempPath you point to a RAM-disk
  1519.          of average size (or your fastest hard-disk). Most of the small
  1520.          archives will fit in the free space and are converted with a
  1521.          reasonable speed. Now if there are bigger archives that don't
  1522.          fit on that drive, MTA will swap to the drive (and directory)
  1523.          that is pointed to by the ALTMTATempPath option. This can be
  1524.          a normal hard-disk (or a slower one) with more free space. The
  1525.          big archives can still be converted !
  1526.  
  1527.          If an archive won't fit on either of the two drives, MTA will
  1528.          (as before) skip the archive.
  1529.  
  1530.  Relate: MTATempPath
  1531.  Dest. : All
  1532.  
  1533.  
  1534.  ┌─────────────────────────────────────────────────────────────────────┐
  1535.  │ MTAErrorPath [dir]                                                  │
  1536.  └─────────────────────────────────────────────────────────────────────┘
  1537.  Usage : When  decompression   fails  (memory, corrupted archive and  so
  1538.          on), MTA will  put the original  archive (even though  it could
  1539.          not be OK)  into the temporary  directory that was  assigned to
  1540.          this file (the directory with  the 8-byte (or more) name  under
  1541.          the current directory  OR under the  directory assigned in  the
  1542.          MTATempPath  option   (see  above).   This  will   lead  to   a
  1543.          maintenance  problem  when  much  archives  fail. All corrupted
  1544.          files are moved to different directories and you need tools  to
  1545.          move  (or  delete)  them  all  AND  to  remove  the   temporary
  1546.          directories.  If  you  do  not  want  this maintenance, you can
  1547.          assign a  special directory  where MTA  places such  files. All
  1548.          you have to do, is to include this option in MTA.CTL.
  1549.  
  1550.          [dir]         This value must point to a valid  drive/directory
  1551.                        which  can  be  used  for  files  in error. If no
  1552.                        drive  is  supplied,  the  default  one  is used.
  1553.                        Relative  directories  (..\WRKDIR  and  such) are
  1554.                        not  advised  but  can  be  used (the are counted
  1555.                        from the  CURRENT directory).  In fact,  relative
  1556.                        directories for this option, are useless in  most
  1557.                        cases.
  1558.  
  1559.  Relate: None
  1560.  Dest. : All
  1561.  
  1562.  
  1563.  ┌─────────────────────────────────────────────────────────────────────┐
  1564.  │ FDUTempPath  [dir]                                                  │
  1565.  │ FDUTrashPath [dir]                                                  │
  1566.  └─────────────────────────────────────────────────────────────────────┘
  1567.  Usage : When you want to  convert whole diskettes to a new  system (use
  1568.          the /D switch,  see later), you  need two special  directories.
  1569.          Without these  directories you  can still  convert archives  on
  1570.          diskette but  you can't  use the  special options  that MTA can
  1571.          offer when  converting diskettes.  There is  a special  chapter
  1572.          about the conversion of diskettes.
  1573.  
  1574.          [dir]         This value must point to a valid  drive/directory
  1575.                        which can be used the  /D option. If no drive  is
  1576.                        supplied,  the  default  one  is  used.  Relative
  1577.                        directories (..\WRKDIR and such) are not  advised
  1578.                        but  can  be  used  (the  are  counted  from  the
  1579.                        CURRENT  directory).   The  directories  must NOT
  1580.                        point  to  the  same  drive  as  you are going to
  1581.                        convert. For a 'mixed' (HDU and FDU) system,  you
  1582.                        must  assign  the  HDU,  for  a  'single'  (FDU 2
  1583.                        times)  system,  you  must  assign a directory on
  1584.                        the other diskette station.
  1585.  
  1586.  Relate: /D option
  1587.  Dest. : All
  1588.  
  1589.  
  1590.  ┌─────────────────────────────────────────────────────────────────────┐
  1591.  │ ITSPath [dir]                                                       │
  1592.  └─────────────────────────────────────────────────────────────────────┘
  1593.  Usage : MTA can be used  in combination with ITS (version 1.06  and all
  1594.          higher versions). When  used in combination  with ITS, MTA  can
  1595.          be stopped like pressing the ESC-key but now without any  human
  1596.          actions involved.  The stopping  of MTA  is ruled  from the ITS
  1597.          task(s) that are running.
  1598.  
  1599.          [dir]         This value must point to a valid  drive/directory
  1600.                        which contains the ITS.SPH  file. If no drive  is
  1601.                        supplied,  the  default  one  is  used.  Relative
  1602.                        directories (..\WRKDIR and such) are not  advised
  1603.                        but  can  be  used  (the  are  counted  from  the
  1604.                        CURRENT directory).
  1605.  
  1606.          MTA MUST find the ITS.SPH file, otherwise MTA will abort,  even
  1607.          when ITS is not  currently in use. If  you don't have (or  use)
  1608.          ITS, you must leave this option OFF.
  1609.  
  1610.  Relate: None
  1611.  Dest. : All
  1612.  
  1613.  
  1614.  ┌─────────────────────────────────────────────────────────────────────┐
  1615.  │ SwapPath [dir]                                                      │
  1616.  └─────────────────────────────────────────────────────────────────────┘
  1617.  Usage : MTA can  (and will)  use a  mechanism to  clear memory when  it
  1618.          needs to. This technique  is called swapping. Swapping  will do
  1619.          the following:
  1620.  
  1621.          - All  data structures  that MTA  uses are  compressed together
  1622.            and written to the swapping device;
  1623.  
  1624.          - All program-coding minus a small piece (the program code  for
  1625.            the swapping itself) will be written to the swapping device;
  1626.  
  1627.          - Memory  is  cleared  an  will  be  rearranged  so it will  be
  1628.            (again) one continuous piece of memory;
  1629.  
  1630.          - The external  program (compressor, decompressor,  exit, virus
  1631.            checker and so on) is called and uses the freed memory;
  1632.  
  1633.          - After termination of the external program, control is  passed
  1634.            to the swapping-code that remained in memory;
  1635.  
  1636.          - The  coding will  (again) rearrange  memory as  it was,  will
  1637.            read   the   program-coding   back   AND   will   read    all
  1638.            data-structures back;
  1639.  
  1640.          - It will clean the swapping device;
  1641.  
  1642.          - It will pass control back to the point where MTA was;
  1643.  
  1644.          With  this  technique,  around  230.000  bytes are removed from
  1645.          memory. These 230.000  were in use  by MTA (non-overlayed)  and
  1646.          there  will  remain  only  a  couple  of bytes for the swapping
  1647.          itself (around 4K bytes).
  1648.  
  1649.          Normally  the  swapping  device  can  be  any  of the following
  1650.          resources:
  1651.  
  1652.          - EMS
  1653.            First   choice,   unless   the   NoEMS   option   (or  /NOEMS
  1654.            command-line parameter)  is supplied  or there  is not enough
  1655.            EMS to contain all data (ca. 230.000 bytes);
  1656.  
  1657.          - XMS
  1658.            Second choice  in SOME  cases. Not  all swapping  routines in
  1659.            MTA  can   support  XMS   yet.  If   the  NoXMS   (or  /NOXMS
  1660.            command-line parameter)  is supplied  or there  is not enough
  1661.            (or no)  XMS to  contain all  data (ca.  230.000 bytes),  MTA
  1662.            will use the next resource;
  1663.  
  1664.          - Disk
  1665.            When there is  not enough (or  no) EMS or  XMS (or the  NoEms
  1666.            and/or NoXMS options are active),  MTA will use disk for  the
  1667.            swapping;
  1668.  
  1669.          When  MTA  is  forced  to  use  disk,  it  will use the current
  1670.          directory for the swap-file that will be created. You can  (and
  1671.          sometimes MUST) overrule this with this option.
  1672.  
  1673.          [dir]         This value must point to a valid  drive/directory
  1674.                        which contains the swapping file. If no drive  is
  1675.                        supplied,  the  default  one  is  used.  Relative
  1676.                        directories (..\WRKDIR and such) are not  advised
  1677.                        but  can  be  used  (the  are  counted  from  the
  1678.                        CURRENT directory).
  1679.  
  1680.          You can also assign a directory  on a RAM-disk when you have  a
  1681.          large one. The only place where MTA disallows disk-swapping  is
  1682.          on  REMOVABLE  drives  (diskettes).  The swap-file (if created)
  1683.          has a  special (unique)  name and  will have  the HIDDEN/SYSTEM
  1684.          attribute. You must NEVER try  to remove such a file  while MTA
  1685.          is still running. It will cause a hangup !
  1686.  
  1687.  Relate: All swapping options
  1688.  Dest. : All
  1689.  
  1690.  
  1691.  ┌─────────────────────────────────────────────────────────────────────┐
  1692.  │ NoEMS                                                               │
  1693.  │ NoXMS                                                               │
  1694.  └─────────────────────────────────────────────────────────────────────┘
  1695.  Usage : When you do not want MTA to use either (or both) EMS or (and)
  1696.          XMS, you can add these option(s) to MTA.CTL. When NoEMS is set
  1697.          and NoXMS isn't and you use QEMM or 386Max (or some program
  1698.          like that), XMS is used. When you set both options, only disk
  1699.          is used. These options are related to the swapping mechanism.
  1700.          This mechanism is the only mechanism in MTA that can make use
  1701.          of EMS/XMS.
  1702.  
  1703.  Relate: All swapping options
  1704.  Dest. : All
  1705.  
  1706.  
  1707.  ┌─────────────────────────────────────────────────────────────────────┐
  1708.  │ MoveToDir [dir]                                                     │
  1709.  └─────────────────────────────────────────────────────────────────────┘
  1710.  Usage :  MTA can,  optionally, move  archives (and  all other converted
  1711.          objects) to another directory  AFTER the conversion. There  are
  1712.          currently 2 different  ways to obtain  this result. One  is the
  1713.          usage of the DefaultPath option (see later), which can be  used
  1714.          by most SysOp's of Bulletin Boards. The other one, the  current
  1715.          option, can be used when  you want to move all  converted files
  1716.          from any directory that you wish to use to a new one.  Normally
  1717.          you will use the  command-line /M to do  so, but if you  always
  1718.          want to have the converted archives on the same place, you  can
  1719.          use the MoveToDir option.
  1720.  
  1721.          [dir]         This value must point to a valid  drive/directory
  1722.                        where  the  files  are  moved  to. If no drive is
  1723.                        supplied,  the  default  one  is  used.  Relative
  1724.                        directories (..\WRKDIR and such) are not  advised
  1725.                        but  can  be  used  (the  are  counted  from  the
  1726.                        CURRENT directory).
  1727.  
  1728.          There  is  one  special  format.  When  combining the /D option
  1729.          (diskette conversion)  with the  MoveToDir (or  the /M command-
  1730.          line parameter), MTA will  convert diskettes from one  diskette
  1731.          to another  one. If  you mix  runs of  MTA to convert diskettes
  1732.          AND to  do normal  conversion, you  can get  problems when this
  1733.          option is put into the MTA.CTL. In such cases it is advised  to
  1734.          use the /M command-line parameter.
  1735.  
  1736.          WARNING: When  you  use  MoveToDir  in  conjunction  with   the
  1737.                   ExitAfterCompression option  you have  to be  aware of
  1738.                   the following extra's:
  1739.  
  1740.                   - When you create an  extra file in the exit  with the
  1741.                     extension  .COM  or  .EXE  which  is  in  the   same
  1742.                     directory   as   the   original   compressed   file,
  1743.                     MoveToDir moves these files also.  When a  name-like
  1744.                     file  already   exist  in   the  MoveToDir    target
  1745.                     directory, MTA  gives you  a warning  and leaves the
  1746.                     file  where  it  was.  This  does  not  go  for  the
  1747.                     original compressed file;
  1748.  
  1749.                   - When  you delete  the original  compression file  in
  1750.                     the  exit,  MTA  will  notice  this and will take no
  1751.                     further actions;
  1752.  
  1753.          When you are running 4Dos <tm> and your original files  contain
  1754.          a  description  in  the  4Dos  description  file,  MTA will use
  1755.          4DOS's MOVE command  to move any  files (if MTA  has detected a
  1756.          full 4DOS environment and the Not4DosAware option is not  set).
  1757.          This  will  cause  any  descriptions  (added  with  4DOS) to be
  1758.          carried along to the new directory.
  1759.  
  1760.  Relate: Not4DosAware, /D command-line parameter
  1761.  Dest. : All
  1762.  
  1763.  
  1764.  ┌─────────────────────────────────────────────────────────────────────┐
  1765.  │ FreeMemory [minfree]                                                │
  1766.  └─────────────────────────────────────────────────────────────────────┘
  1767.  Usage : MTA  uses  memory   very  dynamically.  When  you   convert two
  1768.          different directories you will see that the starting amount  of
  1769.          free memory (displayed by MTA) will never be the same. To  make
  1770.          the  story  short,  almost  every  option  that  can be entered
  1771.          multiple  times  (like  DoNot,  DefaultPath, IncludeFile and so
  1772.          on) will take a  few extra bytes of  memory and all files  that
  1773.          will be  converted (up  to 1000  in one  run) will  also take a
  1774.          dynamic amount of memory. All external calls can be ruled  with
  1775.          a  swap  option  (see  xxxPath,  Virusscanner and all exits) so
  1776.          that is not such  a problem. Also MTA  will take a look  at the
  1777.          memory and  will determine  if it  is possible  to make  itself
  1778.          useful in the presented amount  of bytes. If you still  want to
  1779.          abort  MTA  when  a  specific  number  of  free  bytes  in  NOT
  1780.          available, you can add this option to MTA.CTL.
  1781.  
  1782.          [minfree]     This value must be the number of BYTES (not  KILO
  1783.                        bytes)  that  must  be  free  in order to let MTA
  1784.                        start the conversion.
  1785.  
  1786.          By default MTA will look if  256Kb is free in memory after  all
  1787.          structures are build in memory. You can overrule the test  when
  1788.          you supply 'FreeMemory 0'.
  1789.  
  1790.  Relate: None
  1791.  Dest. : All
  1792.  
  1793.  
  1794.  ┌─────────────────────────────────────────────────────────────────────┐
  1795.  │ Runtime [seconds]                                                   │
  1796.  └─────────────────────────────────────────────────────────────────────┘
  1797.  Usage : MTA can be  interrupted when running attended (by  pressing the
  1798.          ESC key)  but when  you run  UNattended this  can be a problem.
  1799.          When you want to  run MTA for a  certain time (when MTA  is run
  1800.          inside a BBS event for instance), you can supply this option.
  1801.  
  1802.          [seconds]     This value  must be set to the number of  seconds
  1803.                        that MTA must execute.
  1804.  
  1805.          If the time is  over and there are  still files left, MTA  will
  1806.          skip them. To  make sure that  already converted files  are not
  1807.          converted again, it is advised  to either move them to  another
  1808.          directory, use MTA's marking-technique or use the option  where
  1809.          MTA will only convert files that have an earlier date then  the
  1810.          file FILES.MTA (a semaphore file, see later).
  1811.  
  1812.          MTA will always  run somewhat longer  than [seconds]. MTA  will
  1813.          not stop in the middle of a conversion so the one that  started
  1814.          [seconds]-1 will be finished. If  this is a big one,  some time
  1815.          can pass before MTA will terminate.
  1816.  
  1817.  Relate: None
  1818.  Dest. : All
  1819.  
  1820.  
  1821.  ┌─────────────────────────────────────────────────────────────────────┐
  1822.  │ Not4DosAware                                                        │
  1823.  └─────────────────────────────────────────────────────────────────────┘
  1824.  Usage : MTA will do some  internal DOS-calls to see if 4DOS  is present
  1825.          in the machine. If so, MTA will use 4DOS's move on any move  of
  1826.          a file that  will be done  inside MTA. If  there is no  4DOS in
  1827.          usage,  MTA  will  use  its  own  internal  (and quicker) MOVE.
  1828.          4DOS's MOVE is  used to move  any descriptions inside  the file
  1829.          DESCRIPT.ION (a 4DOS internal file which can be present  inside
  1830.          the directory with a HIDDEN attribute).
  1831.  
  1832.          If you don't  use 4DOS descriptions  for your files  and/or you
  1833.          want to use the faster internal  MOVE AND you run 4DOS on  your
  1834.          machine, you can include this option.
  1835.  
  1836.  Relate: MoveToPath (and all internal moves)
  1837.  Dest. : All
  1838.  
  1839.  
  1840.  ┌─────────────────────────────────────────────────────────────────────┐
  1841.  │ VideoMode [mode]                                                    │
  1842.  └─────────────────────────────────────────────────────────────────────┘
  1843.  Usage : MTA can adjust  itself to non-standard text-modes. Some  of the
  1844.          more common examples are 80x43, 132x60 and so on. If you  enter
  1845.          MTA  when  the  screen  is  such  a  mode,  MTA will extend the
  1846.          display in  the actual  number of  lines and,  with modes  that
  1847.          support  more  than   110  characters,  also   the  number   of
  1848.          characters on a line.
  1849.  
  1850.          If you  normally run  in a  normal text-mode  (80x25) but still
  1851.          want to  see MTA  running in  a special  text-mode, you can add
  1852.          this statement to MTA.CTL.
  1853.  
  1854.          [mode]        This  is the  decimal number of  the video   mode
  1855.                        that  MTA  will  try  to  set.  Look  inside your
  1856.                        video-card manual  to see  which mode  you should
  1857.                        use.
  1858.  
  1859.          After MTA  has processed  the MTA.CTL  options, MTA  will reset
  1860.          the video-card to  the supplied mode  (if included in  MTA.CTL)
  1861.          and before termination,  MTA will reset  to the standard  text-
  1862.          mode. If you use an invalid mode, damage to your monitor  could
  1863.          be the case (see video-card manual) or you are not able to  see
  1864.          anything  until  MTA  has  finished  (or  the  machine can even
  1865.          hang).
  1866.  
  1867.          MTA will not alter the video-mode if it can detect that  it  is
  1868.          called under a multi-tasking environment like DesqView <tm>. In
  1869.          these cases the VIDEOMODE option will be obsolete.
  1870.  
  1871.  Relate: None
  1872.  Dest. : All
  1873.  
  1874.  
  1875.  ┌─────────────────────────────────────────────────────────────────────┐
  1876.  │ SubstDrive [drivearray]                                             │
  1877.  └─────────────────────────────────────────────────────────────────────┘
  1878.  Usage : This is a VERY  important option. Most archives include the  so
  1879.          called directory entries. These  are the directories that  were
  1880.          included when the archive was created. If an archive was  made,
  1881.          containing all files (*.*)  from the current directory  and all
  1882.          lower trees AND you supplied the options to include the  actual
  1883.          directories,  given  the  following  structure  (root  is   the
  1884.          current directory):
  1885.  
  1886.          [root, current directory, drive C]
  1887.             CONFIG.SYS
  1888.             [sub-dir HLP]
  1889.             TEST.TST
  1890.                 [sub-dir ZIP]
  1891.                 TEST.TST
  1892.                 [sub-dir ZAP]
  1893.                 TEST.TST
  1894.                    [sub-dir ZA1]
  1895.                    TEST.TST
  1896.                    [sub-dir ZA2]
  1897.                    TEST.TST
  1898.  
  1899.          the  archive  will  contain  one  of the two following formats,
  1900.          either the relative directories:
  1901.  
  1902.          CONFIG.SYS
  1903.          HLP\TEST.TST
  1904.          HLP\ZIP\TEST.TST
  1905.          HLP\ZAP\TEST.TST
  1906.          HLP\ZAP\ZA1\TEST.TST
  1907.          HLP\ZAP\ZA2\TEST.TST
  1908.  
  1909.          or the absolute directories:
  1910.  
  1911.          \CONFIG.SYS
  1912.          \HLP\TEST.TST
  1913.          \HLP\ZIP\TEST.TST
  1914.          \HLP\ZAP\TEST.TST
  1915.          \HLP\ZAP\ZA1\TEST.TST
  1916.          \HLP\ZAP\ZA2\TEST.TST
  1917.  
  1918.          The fact  if there  are ABSOLUTE  or RELATIVE  directories will
  1919.          depend on  the type  of archive  system. Normally  (without the
  1920.          SubstDrive option  set), MTA  will only  convert directories if
  1921.          the  source  archive  system  contains RELATIVE directories AND
  1922.          the target archive system  can contain directory entries.   For
  1923.          some  archivers  you  can  not  be  sure about the fact if they
  1924.          contain ABSOLUTE  or RELATIVE  directories and  some will  ONLY
  1925.          contain  ABSOLUTE  entries.  When  MTA  would  convert  such an
  1926.          archive, it would extract the  archive with all options into  a
  1927.          directory  F:\JUST\AN\EXAMPLE\156DA12F  (just  an  example) but
  1928.          while  decompress  starts,  the  decompress  program  would add
  1929.          files in ABSOLUTE directories, causing NONE of the files to  be
  1930.          added to F:\JUST\AN\EXAMPLE\156DA12F. Files would be stored  in
  1931.          C:\,  C:\HLP\,  C:\HLP\ZIP,  C:\HLP\ZAP,  C:\HLP\ZA1  and   the
  1932.          C:\HLP\ZA2 directory.
  1933.  
  1934.          MTA would be  able to notice  this and could  archive the files
  1935.          from  these  directories  back  into  the new archive (with the
  1936.          delete option) but  there are too  many risks involved.  MTA is
  1937.          created so  UNATTENDED operation  is possible.  To secure this,
  1938.          all warnings  and queries  are suppressed.  MTA would  start to
  1939.          call  the  decompress  program  and  the  first thing that will
  1940.          happen is the overwrite of  CONFIG.SYS on C:\ (all other  files
  1941.          look like if they will  not cause any trouble). When  MTA would
  1942.          start the target-compression program, CONFIG.SYS would then  be
  1943.          archived AND  deleted, leaving  C: without  CONFIG.SYS. Can you
  1944.          imagine what would  happen if files  like IO.SYS and  MSDOS.SYS
  1945.          would be extracted to the root or COMMAND.COM ?
  1946.  
  1947.          Given the  example above,  MTA will  NEVER decompress  archives
  1948.          that could  contain ABSOLUTE  directories unless  you use  some
  1949.          special options. There ARE many archives that have a  structure
  1950.          like this AND you  would still be able  to convert them but  in
  1951.          all cases WITHOUT any risk involved.
  1952.  
  1953.          For this reason, MTA  contains support for SUBSTituted  drives.
  1954.          If you don't know what  the command SUBST means under  DOS, you
  1955.          should read the DOS manual.  In short, SUBST will create  a new
  1956.          drive-letter and the root of  this drive is the same  directory
  1957.          as you supply  to SUBST. So  when you make  a SUBST drive  (G:)
  1958.          from F:\JUST\AN\EXAMPLE\156DA12F (see above), G:\ would be  the
  1959.          same  as   F:\JUST\AN\EXAMPLE\156DA12F  and   all   directories
  1960.          created under G:\ would in fact be created under the  directory
  1961.          F:\JUST\AN\EXAMPLE\156DA12F.  With  this  trick  (which  is   a
  1962.          normal DOS command), you CAN convert archives with  directories
  1963.          that  are  ABSOLUTE  and  you  can  still convert archives with
  1964.          RELATIVE  directories.  If  you  include the SubstDrive option,
  1965.          all  archives  WITH  directories,  no  matter  the  type of the
  1966.          directories, will convert in the  BEST possible way to the  new
  1967.          target (if  the new  target does  not support  directories, MTA
  1968.          can't fix that, but if it does, they will be there).
  1969.  
  1970.          There are some precautions to  take before you start with  this
  1971.          option. First, your DOS must support SUBSTituted drives:
  1972.  
  1973.          - Your DOS  must support SUBSTituted  drives. All DOS  versions
  1974.            from  3.0  and  up  will  contain the support for SUBSTituted
  1975.            drives;
  1976.  
  1977.          - You need the DOS program that can make and delete these  kind
  1978.            of SUBSTituted drives. This  program is called SUBST  (EXE in
  1979.            most cases, sometimes COM).   It would be possible to  have a
  1980.            self-contained  support  in  MTA  but  the  methods to create
  1981.            SUBSTituted drives  vary every  DOS release.  Make sure  that
  1982.            the program  SUBST.EXE or  SUBST.COM is  somewhere inside the
  1983.            DOS-path (MTA will search for the file itself and will  abort
  1984.            if  the  SubstDrive  option  is  set  but  the  SUBST.EXE/COM
  1985.            program isn't found);
  1986.  
  1987.          - You  must alter  the LASTDRIVE  option in  CONFIG.SYS (or set
  1988.            with one of  the QEMM <tm>  utilities) to a  higher value. If
  1989.            your current last drive is F:  and you are going to run  only
  1990.            ONE MTA at a time (it  is possible to run multiple copies  at
  1991.            the same time  under any multi-tasker  like DesqView <tm>  or
  1992.            MS Windows <tm>), you can set it to G:. In fact, you need  as
  1993.            much extra drives as  the number of concurrently  running MTA
  1994.            programs.  If  you  have   a  variable  drive   configuration
  1995.            (sometimes you have a  RAM-disk, sometimes you haven't),  you
  1996.            can also assign a much higher letter. In fact, it is  allowed
  1997.            to use drive Z: for SUBSTituted drives, even if the last  one
  1998.            is F:. In doubt, you  must leave out the LASTDRIVE  option in
  1999.            CONFIG.SYS;
  2000.  
  2001.          - You  must test  the SUBST  program manually  to make  sure is
  2002.            works. Use a directory and  try SUBST on all drives  that are
  2003.            going to use in MTA;
  2004.  
  2005.          If all  points above  are checked,  you can  add the SubstDrive
  2006.          option in MTA.  If you use  the SubstDrive option  with invalid
  2007.          letters things  CAN go  wrong. I  strongly advise  to use drive
  2008.          letters that are NEVER  going to be used  (f.i. Y: and Z:  when
  2009.          running 2  concurrent MTA's  or only  Z: if  you only use one).
  2010.          It IS  possible but  NEVER use  a drive  letter that  is one of
  2011.          your CURRENT drives and certainly  not one of the floppy  drive
  2012.          letters if you want to use the /D option !
  2013.  
  2014.          [drivearray]   You must  supply at  least one  drive-letter but
  2015.                        you  can  supply  op  to  26.  You  must supply a
  2016.                        different  letter  for  each  concurrent MTA that
  2017.                        you  are  going  to  run.  The first MTA (task 1)
  2018.                        uses  the  first  letter,  the  next MTA (task 2)
  2019.                        will  use  the  second  and  so  on  !  With  all
  2020.                        warnings  in  mind,  you  could supply the option
  2021.                        'SubstDrive  Z'  of  one  MTA and 'SubstDrive YZ'
  2022.                        for two concurrently running MTA's;
  2023.  
  2024.          There is  nothing to  worry about  when you  use the SubstDrive
  2025.          option  (unless  you  have  a  very special configuration). MTA
  2026.          will do all the work  for you. MTA will assign  the SUBSTituted
  2027.          drives itself (by calling  SUBST.EXE/COM) and will remove  them
  2028.          again when  conversion is  finished. MTA  will check  the drive
  2029.          letters you supplied  in the SubstDrive  to see if  any of them
  2030.          is a 'real' drive. If this  is the case, MTA will abort.  Under
  2031.          special conditions  this test  may fail  though, so  you should
  2032.          take  all  previous  warnings  in  mind before you start. Don't
  2033.          experiment  with  the  option,  just  do  it  the  way  it   is
  2034.          suggested.
  2035.  
  2036.  Relate: SubstOn, SubstOff
  2037.  Dest. : All
  2038.  
  2039.  
  2040.  ┌─────────────────────────────────────────────────────────────────────┐
  2041.  │ SubstOn [path] {parm}..{parm}                                       │
  2042.  └─────────────────────────────────────────────────────────────────────┘
  2043.  Usage : This  option  can  only   be  used  in  combination  with   the
  2044.          SUBSTDrive  option.   When  used,   the  SubstOff   option   is
  2045.          mandatory.
  2046.  
  2047.          When SubstDrive  is set,  MTA will  use the  following calls to
  2048.          the DOS SUBST.EXE  program to set  the substituted drive  ON or
  2049.          OFF:
  2050.  
  2051.          - On
  2052.            [drive:][dir]\SUBST.EXE [drive_to_page] [dir_to_page_over]
  2053.  
  2054.          - Off
  2055.            [drive:][dir]\SUBST.EXE [drive_to_page] /D
  2056.  
  2057.          Normally  this  will  work  in  the  proper way unless you need
  2058.          another syntax (special DOS-versions) or you even need  another
  2059.          program (networks) to  page (virtual) drives  over directories.
  2060.          For this need,  you can use  the SubstOn and  SubstOff options.
  2061.          With  these  options,  you  can  tell MTA which program(s) with
  2062.          which parameters  are to  be called  to switch  the substituded
  2063.          (paged) drive on (SubstOn) and off (SubstOff):
  2064.  
  2065.          [Path]        This parameter must contain the drive,  directory
  2066.                        and  filename  of  the  program  in question. MTA
  2067.                        will  validate  the working of the program;
  2068.  
  2069.          [parm] {parm} At  this  location   you  can  (must) supply  the
  2070.                        various parameters for  the program. There  are a
  2071.                        few macros  available  that  will  be replaced by
  2072.                        values at run-time. These are:
  2073.  
  2074.                        %DP This  macro will  be replaced  with the drive
  2075.                            letter (without  ':') of  drive that  will be
  2076.                            paged over the temporary directory;
  2077.  
  2078.                        %DF This  macro will  be replaced  with the drive
  2079.                            letter  (WITH  ':')  of  drive  that  will be
  2080.                            paged over the temporary directory;
  2081.  
  2082.                        %PP This macro will be replaced by the  temporary
  2083.                            directory  that  needs  to  be  accessed as a
  2084.                            drive  (normally  a  directory  under the one
  2085.                            you  specified  in  MTATempPath).  This macro
  2086.                            will NOT give a directory with a backslash;
  2087.  
  2088.                        %PF This macro will be replaced by the  temporary
  2089.                            directory  that  needs  to  be  accessed as a
  2090.                            drive  (normally  a  directory  under the one
  2091.                            you  specified  in  MTATempPath).  This macro
  2092.                            WILL give a directory with a backslash;
  2093.  
  2094.                        %NP Same as %PP but without the drive-letter (so
  2095.                            you can create combinations like \\TEM\PAS;
  2096.  
  2097.                        %NF Same as %PF but without the drive-letter (so
  2098.                            you can create combinations like \\TEM\PAS\;
  2099.  
  2100.          Included are  two examples,  one that  will be  the same as MTA
  2101.          uses internally (but now  specified with SubstOn and  SubstOff)
  2102.          and one  for a  network that  needs a  program MAP to subtitute
  2103.          (page the drive).  The first example  is split in  two examples
  2104.          (one with  a DIRECT  call to  SUBST and  one using a batch-file
  2105.          SUBST.BAT):
  2106.  
  2107.          - Using SUBST (THIS IS THE MTA DEFAULT AND NEED NOT BE USED)
  2108.            - Directly:
  2109.              SubstOn  C:\DOS\SUBST.EXE %DF %PP
  2110.              SubstOff C:\DOS\SUBST.EXE %DF /D
  2111.            - Called from a batch-file
  2112.              SubstOn  C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF %PP
  2113.              SubstOff C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF /D
  2114.  
  2115.          - Using MAP (only an example, use your own Network-program)
  2116.            SubstOn  C:\NOV\MAP.EXE   %DF=\%NP
  2117.            SubstOff C:\NOV\MAP.EXE R %DF
  2118.  
  2119.  Relate: SubstOff, NoSubstTest
  2120.  Dest. : All
  2121.  
  2122.  
  2123.  ┌─────────────────────────────────────────────────────────────────────┐
  2124.  │ SubstOff [path] {parm}..{parm}                                      │
  2125.  └─────────────────────────────────────────────────────────────────────┘
  2126.  Usage : See SubstOn (SubstOff is used tro switch the substitution off).
  2127.  
  2128.  Relate: SubstOn, NoSubstTest
  2129.  Dest. : All
  2130.  
  2131.  
  2132.  ┌─────────────────────────────────────────────────────────────────────┐
  2133.  │ NoSubstTest                                                         │
  2134.  └─────────────────────────────────────────────────────────────────────┘
  2135.  Usage : When  substituted  drives  will be used by MTA (either by using
  2136.          SUBST or  any  other  kind  of  program  when  the  SubstOn and
  2137.          SubstOff  options  are used), MTA will check (after the 'subst'
  2138.          drive is assigned)  if  this  new drive is not a REAL drive. In
  2139.          certain  configurations  (networks), MTA  will get a REAL drive
  2140.          back  and  will  abort. In  these  cases  this option should be
  2141.          supplied. It  will  bypass  the test for a REAL drive ! If this
  2142.          is used  in  a  normal  (non-network)  DOS environment, you are
  2143.          bypassing  all  security  checks  and strange things can happen
  2144.          if the  SUBST-drive  actually IS a real drive with files. Never
  2145.          use this  option  unless  you know what you are doing AND after
  2146.          you have  made  a  backup  of the files on the drive(s) in that
  2147.          can/will be used.
  2148.  
  2149.  
  2150.  Relate: SubstOn, SubstOff, SubstDrive
  2151.  Dest. : All
  2152.  
  2153.  
  2154.  ┌─────────────────────────────────────────────────────────────────────┐
  2155.  │ ExtendedTesting                                                     │
  2156.  └─────────────────────────────────────────────────────────────────────┘
  2157.  Usage : Some older  decompress programs  do not  return an  errorlevel
  2158.          when something is wrong with the decompress. For example,  some
  2159.          older PAK versions (GSARC) could signal that one or more  files
  2160.          inside the archive  contained a CRC-error  but returned a  zero
  2161.          errorlevel. In these cases  MTA will think that  the decompress
  2162.          is ok, will remove the archive and will compress the  remaining
  2163.          (if any) files to a new archive, causing only a part (or  none)
  2164.          of the original archive to be converted.
  2165.  
  2166.          MTA can make  sure (for 98%)  that the extracted  files are the
  2167.          same as the  ones that are  in the original  source-archive. To
  2168.          add this fail-save mechanism, you must add the  ExtendedTesting
  2169.          option in  MTA.CTL. MTA  will count  the combined  uncompressed
  2170.          bytes that the  archive will show  to the world  and will count
  2171.          these bytes again (bases on  the actual files) after the  files
  2172.          are decompressed. If they  differ, MTA will delete  these files
  2173.          again and will move the original archive to the directory  that
  2174.          contains the  faulty archives.  A warning  is produced  and the
  2175.          next conversion (if any) will start.
  2176.  
  2177.          There are some special archives that can not be tested for  the
  2178.          full 100%. These are:
  2179.  
  2180.          - ARJ  archives with  files that  are compressed  as TEXT-files
  2181.            ARJ can compress  files as TEXT-files  (-t1 parameter on  the
  2182.            ARJ  command-line).  The  filesize  of  such files inside the
  2183.            ARJ-archive  is  showed  as  the  size  WITHOUT any CR/LF and
  2184.            CTRL-Z  (EOF)  markers.  For  instance,  a  text-file  with 2
  2185.            records, each containing 10 bytes, will normally have a  size
  2186.            of (2 x 10) + (2 x 2  (CRLF)) + 1 is 25 bytes. ARJ will  show
  2187.            this file as a file with a size of 20. THIS IS ONLY THE  CASE
  2188.            with files that are compressed with -t1 !  If MTA detects  an
  2189.            ARJ-file  with  such  text-files  inside,  it  will  skip the
  2190.            extended  test  (not  to  worry,  because  ARJ will return an
  2191.            errorlevel when  the files  inside the  original archive  are
  2192.            not OK). In a  discussion with the author  of ARJ I was  told
  2193.            that  this  has  something  to  do  with  the multi- platform
  2194.            (DOS/UNIX and so on) support;
  2195.  
  2196.          - ARJ  and ZOO  archives with  backups inside  Both ZOO and ARJ
  2197.            archives  can  contain  backup  copies,  even multiple backup
  2198.            copies. When you make an archive with the file A.A inside  an
  2199.            a  few  days  later  you  will  do  this  again (with special
  2200.            ZOO/ARJ command-line options), the  first A.A will be  marked
  2201.            as backup  and the  second is  added. This  can go  on for  a
  2202.            large number of times, eventually resulting in archives  that
  2203.            contain (for  instance) 100  A.A files,  1 of  them being the
  2204.            original (the one  added last) and  99 backups.   There is NO
  2205.            direct  support  archival  backups  in  MTA  but  you CAN add
  2206.            options in MTA  to instruct ARJ  (and ZOO) to  extract all of
  2207.            these backups  (with a  rename, done  by the  archive program
  2208.            itself). Because  this is  possible, MTA  will skip  extended
  2209.            testing  for  archives  with  backups  inside.  This  is   no
  2210.            problem. ARJ and  ZOO will both  report errorlevels when  the
  2211.            decompress fails;
  2212.  
  2213.          It is advised to always use ExtendedTesting. The only  drawback
  2214.          is some loss in speed but on hard-disks this will be less  than
  2215.          a second for each file (average).
  2216.  
  2217.  Relate: None
  2218.  Dest. : All
  2219.  
  2220.  
  2221.  ┌─────────────────────────────────────────────────────────────────────┐
  2222.  │ ShareWait [seconds]                                                 │
  2223.  └─────────────────────────────────────────────────────────────────────┘
  2224.  Usage : You can  run multiple copies of  MTA AND it is  possible to run
  2225.          MTA in a second task (along side a BBS). In these cases it  can
  2226.          be possible  that MTA  needs resources  (files) that  the other
  2227.          task  is  using  also.  In  multi-tasking environments you must
  2228.          always load SHARE (see DOS manual) to give support to  programs
  2229.          that would  like to  share resources  (files). If  MTA needs  a
  2230.          resource  that  is  currently  locked  (a  file  that  is being
  2231.          updated by the other task), it will wait until the resource  is
  2232.          free again unless it  takes to long. If  it takes to long,  MTA
  2233.          will abort.
  2234.  
  2235.          MTA will look every 10 seconds to see if a resource if free  to
  2236.          use again  (after the  initial lock).  This process  will go on
  2237.          for 300  seconds (5  minutes) by  default. After  that, no  new
  2238.          cycle will  start, but  MTA will  abort. You  can also stop the
  2239.          cycle by pressing CTRL-E, in which case MTA will abort.
  2240.  
  2241.          [seconds]     By default, MTA will  look every 10 seconds   for
  2242.                        the duration of 300  seconds. You can alter  this
  2243.                        value  to  anything  you  like.  If  you  want to
  2244.                        change it, you  must supply the  ShareWait option
  2245.                        with  that  number  of  seconds. F.i., 'ShareWait
  2246.                        600' will cause MTA to look every 10 seconds  for
  2247.                        the duration of 600 seconds (is 10 minutes).
  2248.  
  2249.          ShareWait is ONLY needed in a multitasking/network  environment
  2250.          and has no meaning  when SHARE is not  loaded. If SHARE is  not
  2251.          loaded and a lock  occurs (multi-tasking without sharing),  MTA
  2252.          will abort directly !
  2253.  
  2254.  Relate: None
  2255.  Dest. : All
  2256.  
  2257.  
  2258.  ┌─────────────────────────────────────────────────────────────────────┐
  2259.  │ AltDisplay                                                          │
  2260.  └─────────────────────────────────────────────────────────────────────┘
  2261.  Usage : When running  in a  normal 80x25  text-screen, MTA can  display
  2262.          two different kind of information windows on the right side  of
  2263.          the  screen.  The  normal  one  contains  a summary of the most
  2264.          important options.  The other  one contains  a dynamic  list of
  2265.          the archives  that still  need to  be converted.  You can  swap
  2266.          between the list with  the 'T' key but  you can also force  MTA
  2267.          to display the dynamic file-list  at startup. In that case  you
  2268.          can  still  swap  screens  with  the  'T'  key, but the dynamic
  2269.          window is the first one to show up when you start MTA.
  2270.  
  2271.          To force  MTA to  start with  the dynamic  file-list, you  must
  2272.          supply the AltDisplay option.  When running in 110+x25+  modes,
  2273.          MTA will always display BOTH windows and the AltDisplay  option
  2274.          will be ignored.
  2275.  
  2276.  Relate: None
  2277.  Dest. : All
  2278.  
  2279.  
  2280.  ┌─────────────────────────────────────────────────────────────────────┐
  2281.  │ WarningTime [cycles]                                             (*)│
  2282.  └─────────────────────────────────────────────────────────────────────┘
  2283.  Usage : MTA will sometimes give a  warning or an error. In this case  a
  2284.          message is displayed and a  'running light' is displayed for  a
  2285.          number of  cycles. You  can stop  the cycles  by hitting ESC or
  2286.          you can wait until it is finished (around 20 seconds).
  2287.  
  2288.          [cycles]      By default, MTA  will use 20 cycles   (equivalent
  2289.                        to 20 seconds). You  can supply any value  from 0
  2290.                        (no cycles) to 65535.
  2291.  
  2292.          If you supply a value of  zero, MTA will also stop making  some
  2293.          noise when errors or warnings are displayed. If you supply  any
  2294.          non-zero value,  MTA will  beep when  an error  or a warning is
  2295.          displayed unless the NoBeep option is active.
  2296.  
  2297.  Relate: NoBeep
  2298.  Dest. : All
  2299.  (*)   : Marked options are also in usage by: MTM
  2300.  
  2301.  
  2302.  ┌─────────────────────────────────────────────────────────────────────┐
  2303.  │ NoBeep                                                              │
  2304.  └─────────────────────────────────────────────────────────────────────┘
  2305.  Usage : By default  MTA will produce a  beep on the PC-speaker  when an
  2306.          error or warning is displayed (or when MTA is finished).  There
  2307.          will be no  sound when WarningTIme  equals a value  of zero but
  2308.          in this case you  will also not see  any messages. If you  want
  2309.          to see  messages but  you dislike  the sound,  you must use the
  2310.          NoBeep option in MTA.CTL.
  2311.  
  2312.  Relate: WarningTime
  2313.  Dest. : All
  2314.  
  2315.  
  2316.  
  2317.  3.3.3 Statements that define the logging
  2318.  ───────────────────────────────────────────────────────────────────────
  2319.  MTA can log almost anything.  The following statements define the  type
  2320.  of logging (if any)  for the several actions  and the actual format  of
  2321.  the logged records.
  2322.  
  2323.  ┌─────────────────────────────────────────────────────────────────────┐
  2324.  │ LogPath [dir]                                                       │
  2325.  │ LogPath [path]                                                      │
  2326.  └─────────────────────────────────────────────────────────────────────┘
  2327.  Usage : MTA can log almost everything. Under normal conditions you  can
  2328.          choose not to log (it will  speed things up a little) but  then
  2329.          you will not be able to create statistical reports and  nothing
  2330.          can be traced back. In a BBS environment you can choose to  log
  2331.          in  the  same  log-file  as  the  one  that is used by your BBS
  2332.          program. In all cases  MTA will try to  open the log in  shared
  2333.          append mode, so current logs will appended to and full  sharing
  2334.          is available. There  are two different  ways you can  setup the
  2335.          logging:
  2336.  
  2337.          [dir]         This value must point to a valid  drive/directory
  2338.                        where logging  will take  place. If  no drive  is
  2339.                        supplied,  the  default  one  is  used.  Relative
  2340.                        directories (..\WRKDIR and such) are not  advised
  2341.                        but  can  be  used  (the  are  counted  from  the
  2342.                        CURRENT directory).   In this  case MTA  will try
  2343.                        to open the file  with the name MTA.LOG  and will
  2344.                        append  to  it  when  it  is present or create it
  2345.                        when it is not (yet) available;
  2346.  
  2347.          [path]        This value must point to a valid  drive/directory
  2348.                        and  filename  of  the  log-file.  If no drive is
  2349.                        supplied,  the  default  one  is  used.  Relative
  2350.                        directories (..\WRKDIR and such) are not  advised
  2351.                        but  can  be  used  (the  are  counted  from  the
  2352.                        CURRENT directory).   In this  case MTA  will try
  2353.                        to open the file with the SUPPLIED name and  will
  2354.                        append  to  it  when  it  is present or create it
  2355.                        when it is not (yet) available;
  2356.  
  2357.          The LogPath option only assigns the actual log-file or (if  not
  2358.          present) will force to 'noLog'. The style of logging that  will
  2359.          be used, will depend on other options. Inside the log-file  you
  2360.          will  see  information,  statistics,  warnings  and errors. The
  2361.          earlier MTA versions contained a ErrorLogPath option. With  the
  2362.          15.01 release (and higher) this option has become obsolete.
  2363.  
  2364.  Relate: LogStyleFormat
  2365.  Dest. : All
  2366.  
  2367.  
  2368. │┌─────────────────────────────────────────────────────────────────────┐
  2369. ││ LogThreshold [bytes]                                                │
  2370. │└─────────────────────────────────────────────────────────────────────┘
  2371. │Usage : This  option  is used by both MTA and MTL. You can set a number
  2372. │        of bytes which  will be  the  threshold for both MTA and MTL to
  2373. │        do a special function.
  2374. │
  2375. │        [bytes]       This must be a numeric (positive) value that will
  2376. │                      be used as the threshold;
  2377. │
  2378. │        If the  log-file (as defined on the LOGPATH option) gets bigger
  2379. │        than [bytes], MTA  will  terminate  with  an errorlevel that is
  2380. │        100 bigger  than  normal. Currently  MTA can terminate with the
  2381. │        errorlevels  0 (normal termination), 16 (abnormal termination),
  2382. │        100 (normal  termination and LOG-file is bigger than [bytes] or
  2383. │        116 (abnormal termination and LOG-file is bigger that [bytes]).
  2384. │
  2385. │        MTL will  use  the  LogThreshold  option  to  detect if the log
  2386. │        has to  be  compressed  (when MTL  is executed with /BATCH) and
  2387. │        will  (or will not)  compress  the  log according to the actual
  2388. │        size.
  2389. │
  2390. │        MTA can  work  with  errorlevel  for this function, to overcome
  2391. │        a useless call to MTL.
  2392. │
  2393. │        You can setup  a  batch  where  you can test the errorlevel and
  2394. │        call MTL when the errorlevel is 100 or 116.
  2395. │
  2396. │Relate: LogPath and MTL
  2397. │Dest. : All
  2398.  
  2399.  
  2400.  ┌─────────────────────────────────────────────────────────────────────┐
  2401.  │ AVLogPath [dir]                                                     │
  2402.  │ AVLogPath [path]                                                    │
  2403.  └─────────────────────────────────────────────────────────────────────┘
  2404.  Usage : MTA can log AV-codes and names. Under normal conditions you can
  2405.          choose not to log (it will  speed things up a little) but  then
  2406.          you will  not  be  able  to  see which AV-codes belong to which
  2407.          authors. This  log-file  will  contain AV-numbers (from ZIP and
  2408.          ARJ files) and  the  names that belong to that numbers. The log
  2409.          can be a help when you setup the IncludeAVFile option(s). Never
  2410.          point  to  the  same  log as in the LogPath option. The general
  2411.          format  of  the  AV-log  is quite different than the normal log
  2412.          that MTA maintains !
  2413.          There are two different ways you can setup the logging:
  2414.  
  2415.          [dir]         This value must point to a valid  drive/directory
  2416.                        where logging  will take  place. If  no drive  is
  2417.                        supplied,  the  default  one  is  used.  Relative
  2418.                        directories (..\WRKDIR and such) are not  advised
  2419.                        but  can  be  used  (the  are  counted  from  the
  2420.                        CURRENT directory).   In this  case MTA  will try
  2421.                        to open the file  with the name MTA.LOG  and will
  2422.                        append  to  it  when  it  is present or create it
  2423.                        when it is not (yet) available;
  2424.  
  2425.          [path]        This value must point to a valid  drive/directory
  2426.                        and  filename  of  the  log-file.  If no drive is
  2427.                        supplied,  the  default  one  is  used.  Relative
  2428.                        directories (..\WRKDIR and such) are not  advised
  2429.                        but  can  be  used  (the  are  counted  from  the
  2430.                        CURRENT directory).   In this  case MTA  will try
  2431.                        to open the file with the SUPPLIED name and  will
  2432.                        append  to  it  when  it  is present or create it
  2433.                        when it is not (yet) available;
  2434.  
  2435.  Relate: None
  2436.  Dest. : All
  2437.  
  2438.  
  2439.  ┌─────────────────────────────────────────────────────────────────────┐
  2440.  │ NormalPasswordListPath [dir]                                        │
  2441.  │ NormalPasswordListPath [path]                                       │
  2442.  └─────────────────────────────────────────────────────────────────────┘
  2443.  Usage : When  you   create  archives  with passwords  (/OP command-line
  2444.          parameter), MTA will  log these archives  (and passwords) in  a
  2445.          special  log-file.  This  log-file  CAN  be  the  same  as  the
  2446.          log-file that is assigned in the LogPath option or it can be  a
  2447.          different  log.  The  usage  of NormalPasswordListPath is fully
  2448.          optional but if you leave it out and you use passwords for  the
  2449.          target  archives  you  must  remember  the  passwords from your
  2450.          head.
  2451.  
  2452.          [dir]         This value must point to a valid  drive/directory
  2453.                        where logging  will take  place. If  no drive  is
  2454.                        supplied,  the  default  one  is  used.  Relative
  2455.                        directories (..\WRKDIR and such) are not  advised
  2456.                        but  can  be  used  (the  are  counted  from  the
  2457.                        CURRENT directory).   In this  case MTA  will try
  2458.                        to open the file  with the name MTA.NPW  and will
  2459.                        append  to  it  when  it  is present or create it
  2460.                        when it is not (yet) available;
  2461.  
  2462.          [path]        This value must point to a valid  drive/directory
  2463.                        and  filename  of  the  log-file.  If no drive is
  2464.                        supplied,  the  default  one  is  used.  Relative
  2465.                        directories (..\WRKDIR and such) are not  advised
  2466.                        but  can  be  used  (the  are  counted  from  the
  2467.                        CURRENT directory).   In this  case MTA  will try
  2468.                        to open the file with the SUPPLIED name and  will
  2469.                        append  to  it  when  it  is present or create it
  2470.                        when it is not (yet) available;
  2471.  
  2472.  Relate: RandomPasswordListPath, LogStyleFormat
  2473.  Dest. : All
  2474.  
  2475.  
  2476.  ┌─────────────────────────────────────────────────────────────────────┐
  2477.  │ RandomPasswordListPath [dir]                                        │
  2478.  │ RandomPasswordListPath [path]                                       │
  2479.  └─────────────────────────────────────────────────────────────────────┘
  2480.  Usage : MTA has  an option  to assign  RANDOM passwords  to the  target
  2481.          archives (the /OP@ command-line parameter). The files that  are
  2482.          converted and  the passwords  that have  been assigned  to each
  2483.          file MUST be logged. If you  leave out this option and you  use
  2484.          /OP@, MTA will  ENFORCE the logging  in the current  directory,
  2485.          otherwise  it  uses  the  values  that  are  supplied with this
  2486.          option.
  2487.  
  2488.          [dir]         This value must point to a valid  drive/directory
  2489.                        where logging  will take  place. If  no drive  is
  2490.                        supplied,  the  default  one  is  used.  Relative
  2491.                        directories (..\WRKDIR and such) are not  advised
  2492.                        but  can  be  used  (the  are  counted  from  the
  2493.                        CURRENT directory).   In this  case MTA  will try
  2494.                        to open the file  with the name MTA.PWD  and will
  2495.                        append  to  it  when  it  is present or create it
  2496.                        when it is not (yet) available;
  2497.  
  2498.          [path]        This value must point to a valid  drive/directory
  2499.                        and  filename  of  the  log-file.  If no drive is
  2500.                        supplied,  the  default  one  is  used.  Relative
  2501.                        directories (..\WRKDIR and such) are not  advised
  2502.                        but  can  be  used  (the  are  counted  from  the
  2503.                        CURRENT directory).   In this  case MTA  will try
  2504.                        to open the file with the SUPPLIED name and  will
  2505.                        append  to  it  when  it  is present or create it
  2506.                        when it is not (yet) available;
  2507.  
  2508.  Relate: NormalPasswordListPath, LogStyleFormat
  2509.  Dest. : All
  2510.  
  2511.  
  2512.  ┌─────────────────────────────────────────────────────────────────────┐
  2513.  │ LogStyleFormat [styleformat]                                        │
  2514.  └─────────────────────────────────────────────────────────────────────┘
  2515.  Usage : MTA creates  several log-records  under different   conditions.
  2516.          You  can  use  the  standard  log,  but  Sysop's hate all these
  2517.          different log-files  (in general).   MTA can  create customized
  2518.          log-records. With this option,  you can instruct MTA  to create
  2519.          records that  look the  same as  the records  from your  mailer
  2520.          and/or  BBS  program.    The  option  LogStyleFormat  and   the
  2521.          following LogDateFormat/LogTimeFormat  combination can  be used
  2522.          to define  the style  of the  log-records that  MTA will create
  2523.          for  ALL  three   log-files  (LogPath,   NormalPasswordListPath
  2524.          RandomPasswordListPath   log-files).     These   options    are
  2525.          implemented with the idea  that different log-styles only  vary
  2526.          at the start of the records and NOT at the end.
  2527.  
  2528.          The LogStyleFormat  defines the  'structure' of  the log-record
  2529.          header. The format is free but with three special cases:
  2530.  
  2531.          - Spaces must be replaced by underscore characters '_';
  2532.  
  2533.          - The  part  of  the  record  that  contains  the date must  be
  2534.            defined with %D (if a date is wanted);
  2535.  
  2536.          - The  part  of  the  record  that  contains  the time must  be
  2537.            defined with %T (if a time is wanted);
  2538.  
  2539.          - Any  extra CRLF  combinations (to  create a  separation line)
  2540.            must be defined with ^M;
  2541.  
  2542.          [styleformat] This  is  the  actual  string  that  defines  the
  2543.                        format of the log-header. You can use two  macros
  2544.                        inside this string, the %T that will be  replaced
  2545.                        with the time  in the format  as supplied in  the
  2546.                        LogTimeFormat  option   and  %D   that  will   be
  2547.                        replaced with the date in the format as  supplied
  2548.                        in  the  LogDateFormat  option.  You must observe
  2549.                        the 4 rules that are described above;
  2550.  
  2551.          An example  (also read  LogDateFormat and  LogTimeFormat for  a
  2552.          description  of  the  time  and  date  functions).  You want to
  2553.          create records that look like this:
  2554.  
  2555.          +  6 Jan 1990   2:00p   The-start-of-the-log
  2556.  
  2557.          The 'The-start-of-the-log' part  is constructed by  MTA itself,
  2558.          so  you  have  only  to  define  the  header.  This  is done as
  2559.          follows:
  2560.  
  2561.          LogStyleFormat +_%D__%T___       (The '_' replaces the spaces)
  2562.          LogDateFormat  DD_nnn_yyyy
  2563.          LogTimeFormat  HH:mmt
  2564.  
  2565.          %D and %T are  replaced by MTA with  the date and time  formats
  2566.          as  supplied  in   LogDateFormat  and  LogTimeFormat.   MTA.CTL
  2567.          contains  a  number  of  examples  for  the  various BBS/Mailer
  2568.          programs.
  2569.  
  2570.  Relate: LogStartStyleFormat, LogDateFormat, LogTimeFormat
  2571.  Dest. : All
  2572.  
  2573.  
  2574.  ┌─────────────────────────────────────────────────────────────────────┐
  2575.  │ LogStartStyleFormat [styleformat]                                   │
  2576.  └─────────────────────────────────────────────────────────────────────┘
  2577.  Usage : This   is  an   additional    option  you   can use along  with
  2578.          the previous   LogStyleFormat  option.   Some  types   of   log
  2579.          use  a special  format  where   the  actual  date  is put  into
  2580.          an extra record  (with- out any   further meaning than  logging
  2581.          the date).   MTA can create  such a record   for you. MTA  will
  2582.          put   the     record   with   the   format   you   supply    in
  2583.          LogStartStyleFormat into the  log as the first and only  record
  2584.          for THIS run of MTA. If MTA  stops and is started again, a  new
  2585.          record of this type is written.
  2586.  
  2587.          [styleformat] This  is  the  actual  string  that  defines  the
  2588.                        format of  the log-file  start. You  can use  two
  2589.                        macros inside  this string,  the %T  that will be
  2590.                        replaced with the time in the format as  supplied
  2591.                        in the LogTimeFormat option  and %D that will  be
  2592.                        replaced with the date in the format as  supplied
  2593.                        in  the  LogDateFormat  option.  You must observe
  2594.                        the 4 rules that are described above;
  2595.  
  2596.          A type of log with this  format is found in the FrontDoor  <tm>
  2597.          mailer. The  options you  can use  in this  logstyle-format are
  2598.          the same as with the LogStyleFormat option.
  2599.  
  2600.  Relate: LogStyleFormat, LogDateFormat, LogTimeFormat
  2601.  Dest. : All
  2602.  
  2603.  
  2604.  ┌─────────────────────────────────────────────────────────────────────┐
  2605.  │ LogDateFormat [styleformat]                                         │
  2606.  └─────────────────────────────────────────────────────────────────────┘
  2607.  Usage : LogDateFormat is used to define the 'date part' (actually the
  2608.          %D) in the LogStyleFormat option. MTA can is able to replace a
  2609.          number of characters (macros) by parts that make up the date.
  2610.          You can (must) also include special date-separation characters
  2611.          so your newly created date will actually look like a data !
  2612.  
  2613.          [styleformat] This is the actual string that defines the
  2614.                        format of the %D macros, used in the options
  2615.                        LogStyleFormat and LogStartStyleFormat. The
  2616.                        [styleformat] must be coded in the format you
  2617.                        want the date to have. Spaces, used as the
  2618.                        separation between components of the date, must
  2619.                        be coded as spaces (and not as '_' characters).
  2620.                        The following codes can be used:
  2621.  
  2622.                        mm    Month with a (optionally) leading zero
  2623.  
  2624.                        MM    Month  ,,         ,,         ,,   space
  2625.  
  2626.                        dd    Day    ,,         ,,         ,,   zero
  2627.  
  2628.                        DD    Day    ,,         ,,         ,,   space
  2629.  
  2630.                        yy    Year  (format: 92  )
  2631.  
  2632.                        yyyy  Year  (format: 1992)
  2633.  
  2634.                        nnn   Name of the  month (with mixed  case,  like
  2635.                              Jan, Oct  and so  on). The  length of 'nnn'
  2636.                              will  rule  the  length  of  the  name,  so
  2637.                              'nnnn' will be replaced by 'Janu';
  2638.  
  2639.                        NNN   Name of  the month  (UPPER case,  like  JAN
  2640.                              OCT and  so on).  The length  of 'nnn' will
  2641.                              rule  the  length  of  the  name, so 'NNNN'
  2642.                              will be replaced by 'JANU';
  2643.  
  2644.                        www   Name of  the day  (with mixed  case,   like
  2645.                              Fri, Sat  and so  on). The  length of 'www'
  2646.                              will  rule  the  length  of  the  name,  so
  2647.                              'wwww' will be replaced by 'Frid';
  2648.  
  2649.                        WWW   Name of  the month  (UPPER case,  like  FRI
  2650.                              SAT and  so on).  The length  of 'nnn' will
  2651.                              rule  the  length  of  the  name, so 'WWWW'
  2652.                              will be replaced by 'FRID';
  2653.  
  2654.          Some valid examples (notice the separation characters that  are
  2655.          coded between the macros):
  2656.  
  2657.          mm/dd/yy         01/31/90
  2658.          MM-dd-yy          1-31-90
  2659.          dd/mm/yyyy       31/01/1990
  2660.          dd/mm/yyyy       31/01/1990
  2661.          dd NNN yyyy      31 JAN 1990
  2662.          dd nnn yy        31 Jan 1990
  2663.          dd n yyyy        31 J 1990
  2664.          www dd nnn yyyy  Sun 31 Jan 1990
  2665.  
  2666.  Relate: LogStyleFormat, LogStartStyleFormat
  2667.  Dest. : All
  2668.  
  2669.  
  2670.  ┌─────────────────────────────────────────────────────────────────────┐
  2671.  │ LogTimeFormat [styleformat]                                         │
  2672.  └─────────────────────────────────────────────────────────────────────┘
  2673.  Usage : LogTimeFormat is used  to define the 'time part'  (actually the
  2674.          %T) in the LogStyleFormat option. MTA can is able to replace  a
  2675.          number of characters (macros) by  parts that make up the  time.
  2676.          You can (must) also include special time-separation  characters
  2677.          so your newly created time will actually look like a time !
  2678.  
  2679.          [styleformat]  This  is  the  actual  string  that  defines the
  2680.                        format  of  the  %T  macros,  used in the options
  2681.                        LogStyleFormat   and   LogStartStyleFormat.   The
  2682.                        [styleformat]  must  be  coded  in the format you
  2683.                        want  the  time  to  have.  Spaces,  used  as the
  2684.                        separation between components  of the time,  must
  2685.                        be coded as spaces  (and not as '_'  characters).
  2686.                        The following codes can be used:
  2687.  
  2688.                        hh    Hour  with a (optionally) leading zero
  2689.  
  2690.                        HH    Hour   ,,         ,,         ,,   space
  2691.  
  2692.                        mm    Min    ,,         ,,         ,,   zero
  2693.  
  2694.                        MM    Min    ,,         ,,         ,,   space
  2695.  
  2696.                        ss    Sec    ,,         ,,         ,,   zero
  2697.  
  2698.                        SS    Sec    ,,         ,,         ,,   zero
  2699.  
  2700.                        t     will be replaced by 'p' (in pm) or 'a'  (in
  2701.                              am);
  2702.  
  2703.                        T     will be replaced by 'P' (in PM) or 'A'  (in
  2704.                              AM);
  2705.  
  2706.                        e     will be  replaced with 'm'  (in am or   pm)
  2707.                              and must be combined with 'T' or 't';
  2708.  
  2709.                        E     will be  replaced with 'M'  (in AM or   PM)
  2710.                              and must be combined with 'T' or 't';
  2711.  
  2712.                        If   you    leave   out    any    't'/'T'/'e'/'E'
  2713.                        combination, the time will be in 24-hour format.
  2714.  
  2715.          Some  valid  examples  (notice  the  separation characters that
  2716.          are coded between the macros):
  2717.  
  2718.          hh:mm            14:00
  2719.          hh.mmt           02.00p
  2720.          HH:mmte           2:00pm
  2721.          HH:mm:ss         14:00:45
  2722.          hh:mm:ss         14:00:45
  2723.  
  2724.  Relate: LogStyleFormat, LogStartStyleFormat
  2725.  Dest. : All
  2726.  
  2727.  
  2728.  
  2729.  3.3.4 Statements that define the selection of files
  2730.  ───────────────────────────────────────────────────────────────────────
  2731.  There are several options in MTA.CTL that rule the selection of  files.
  2732.  Most of  them are  described in  this chapter.  Those which  have to do
  2733.  with  the  selection  of  files  in  a BBS environment (SysOp's) can be
  2734.  found in the chapter that describes the special BBS parameters.
  2735.  
  2736.  ┌─────────────────────────────────────────────────────────────────────┐
  2737.  │ DefaultPath [dir] {targetdir}                                       │
  2738.  └─────────────────────────────────────────────────────────────────────┘
  2739.  Usage : Without any  special options,  MTA will  start working  in  the
  2740.          current directory. There are several ways to overrule this  (by
  2741.          default in MTA.CTL or temporary  on the command-line).  One  of
  2742.          the  options  that  can  be  used  by both BBS operators and by
  2743.          normal users, is this DefaultPath option. With this option  you
  2744.          force MTA  to convert  files that  are in  the directories that
  2745.          you supply on one or more (up to 255) DefaultPath options.
  2746.  
  2747.          If you  don't do  special actions  AND you  leave the converted
  2748.          files inside  the directories  that you  assign with  the FIRST
  2749.          parameter of this option, MTA will convert them AGAIN when  you
  2750.          start MTA for the second  (and further) time. You can  fix this
  2751.          problem  by  either  marking  the   files  as  done  (see   the
  2752.          MarkString  related  options)  or  by  using  the  OnlyNewFiles
  2753.          option  or  by  moving  them  to  another directory that is not
  2754.          touched by MTA, either automatically or by hand.
  2755.  
  2756.          The selection of  which files inside  these directories are  to
  2757.          be converted is  ruled by the  file-mask(s) that you  supply on
  2758.          the command-line.
  2759.  
  2760.          [dir]         This value must point to a valid  drive/directory
  2761.                        where conversion will take place. If no drive  is
  2762.                        supplied,  the  default  one  is  used.  Relative
  2763.                        directories (..\WRKDIR and such) are not  advised
  2764.                        but  can  be  used  (the  are  counted  from  the
  2765.                        CURRENT directory).
  2766.  
  2767.          {targetdir}   This value  CAN point to a valid  drive/directory
  2768.                        where  files  that  are  converted  in  [dir] are
  2769.                        moved to AFTER the conversion. If no  {targetdir}
  2770.                        is   supplied,   the   files   stay   in   [dir].
  2771.                        Relative  directories  (..\WRKDIR  and  such) are
  2772.                        not  advised  but  can  be  used (the are counted
  2773.                        from the  CURRENT directory).  This parameter  is
  2774.                        optional !!
  2775.  
  2776.          There can  be up  to 255  DefaultPath options.  You can mix the
  2777.          formats (some  of them  can have  a {targetdir},  some of  them
  2778.          don't have this parameter).
  2779.  
  2780.          If  you  use  the  /W  command-line  parameter, the DefaultPath
  2781.          options are ignored ! If  you use the full-screen selection  of
  2782.          files (MTA is  started without any  file-mask), ONLY the  first
  2783.          directory is  converted and  all other  DefaultPath options are
  2784.          ignored !
  2785.  
  2786.  Relate: QBBSPaths, RAPaths, MAXPaths for BBS systems)
  2787.  Dest. : All
  2788.  
  2789.  
  2790.  ┌─────────────────────────────────────────────────────────────────────┐
  2791.  │ DoNot [filemask]                                                    │
  2792.  │ DoNot [path]                                                        │
  2793.  └─────────────────────────────────────────────────────────────────────┘
  2794.  Usage : When   you   use     MTA      unattended   or   you     convert
  2795.          complete directories   (with  f.i.   DefaultPath  options)   it
  2796.          is possible  that   files   are   converted   that   you  don't
  2797.          want to convert.  Examples of  these files  are many  but  most
  2798.          commonly, you can think of files that  came from programs  like
  2799.          XRS (734B0384.TU1 and such) or  files that have a public  usage
  2800.          (like  NODEDIFF.A23 and such).
  2801.  
  2802.          The DoNot option  can be used  to exclude some  files EVEN when
  2803.          they match  the file-mask  selection on  the command-line.  You
  2804.          can use up to 255 of EACH these options (so 255 with [path] AND
  2805.          255 with [filemask]).
  2806.  
  2807.          [path]        This parameter must contain a complete path with
  2808.                        filemask,  so drive, directory and filemask like
  2809.                        in E:\ZIP\*.A??.  Wildcards  in the filemask can
  2810.                        be used (see below);
  2811.  
  2812.          [filemask]    The parameter must  contain a single   file-mask.
  2813.                        You  can  use  the  normal  DOS  wildcards (?,*).
  2814.                        Also  a  special  wildcard  (=)  can be used. '='
  2815.                        will test  for a  shifting match.  So '=WAR' will
  2816.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  2817.                        will NOT  match with  nodedifF.Zip. In  this case
  2818.                        you  must  use  =F.Z;
  2819.  
  2820.          When using the /D and AllDisketteFiles options together,  files
  2821.          are NEVER excluded.  This is also  the case when  MTA does call
  2822.          to itself (compressed-in-compressed files).
  2823.  
  2824.  Relate: None
  2825.  Dest. : All
  2826.  
  2827.  
  2828.  ┌─────────────────────────────────────────────────────────────────────┐
  2829.  │ SFXFiles                                                            │
  2830.  └─────────────────────────────────────────────────────────────────────┘
  2831.  Usage : With  archive conversion you  have to deal  with so called  SFX
  2832.          files. These  are SelF  eXtracting archives.  In general,  this
  2833.          are normal COM or  EXE files that can  be started as a  program
  2834.          and which task  only is to  decompress all files  that are also
  2835.          inside  this  COM/EXE  file.  SFX  files  are commonly used for
  2836.          distribution of  the archive  programs them  self. It  would be
  2837.          rather  difficult  to  decompress  PKZ110.ZIP  if  this was the
  2838.          first time you got  involved with ZIP, so  such a file will  be
  2839.          distributed as PKZ110.EXE.
  2840.  
  2841.          MTA is able to convert SFX files into a new target system.   To
  2842.          do so, it must be able to recognize such a file as an  archive.
  2843.          These is a lot of coding involved  in MTA to do so and I  won't
  2844.          say that the coding  can trap 100% of  each cases.  Most  other
  2845.          products that  involve archives  will tell  you that  they will
  2846.          recognize SFX  files for  100% but  most of  them will  fail on
  2847.          occasion. A SFX archive contains some executable coding at  the
  2848.          start of the archive.  MTA must be able  (and is) to skip  this
  2849.          coding  and  to  look  for  the  archive  part.  To keep MTA as
  2850.          'generic' as possible, there is no SPECIFIC code for each  type
  2851.          of header.  This would  make maintenance  almost an  impossible
  2852.          job because the headers change with every new version of  every
  2853.          archive that supports  SFX archives. Up  to now, MTA  has never
  2854.          failed its  job BUT  it is  possible that  MTA will recognize a
  2855.          normal  EXE/COM  file  as  being  a  SFX  file.   This is not a
  2856.          problem because the decompression of such a file will fail  and
  2857.          the file will stay as it is.
  2858.  
  2859.          Normally MTA  will NOT  (by default)  convert SFX  archives. If
  2860.          you  supply  this  option,  MTA  will also start converting SFX
  2861.          files  if  they  match  the  file-masks  that you supply on the
  2862.          command-line.
  2863.  
  2864.  Relate: None
  2865.  Dest. : All
  2866.  
  2867.  
  2868.  ┌─────────────────────────────────────────────────────────────────────┐
  2869.  │ MaxGifDim [w] [h] [c]                                               │
  2870.  └─────────────────────────────────────────────────────────────────────┘
  2871.  Usage : This  option  rules   the  selection  of GIF files. It  is only
  2872.          needed when you  run the unregistered  version of GIFLITE  <tm>
  2873.          but  will  also  work  for  GIF  to JPEG conversions. With this
  2874.          option you instruct MTA only to select GIF files that have  the
  2875.          same or a  lower resolution. The  option is ignored  when using
  2876.          GIF as  the compression  type (GIFTEST).  For this  conversion,
  2877.          you   can   add   a   command-line   parameter   for    GIFTEST
  2878.          (GTECompression option) in which  case GIFTEST will reject  all
  2879.          GIF files with dimensions LOWER than a specific one.
  2880.  
  2881.          [w] [h] [c]   With this  3 parameters you  define the   maximum
  2882.                        resolution of  GIF files  what will  be selected.
  2883.                        The values 640  480 256 will  be useful when  you
  2884.                        use the  unregistered version  of GIFLITE,  other
  2885.                        values can be set to narrow the selection.
  2886.  
  2887.          Please notice that  the three parameters  have an OR  relation.
  2888.          If one of them is smaller  than the actual resolution of a  GIF
  2889.          file, the  file is  not selected.  So a  641*479*255 GIF is NOT
  2890.          selected when  the option  is set  to 640  480 256  because the
  2891.          weight (641) is higher than 640.
  2892.  
  2893.  Relate : GIFLite
  2894.  Dest   : GIF types
  2895.  
  2896.  
  2897.  ┌─────────────────────────────────────────────────────────────────────┐
  2898.  │ NoMarked                                                            │
  2899.  └─────────────────────────────────────────────────────────────────────┘
  2900.  Usage : What if you have one or more directories that contain  archives
  2901.          and where you want to  convert ONLY archives that haven't  been
  2902.          converted before ? So a directory contains 20 ZIP archives  and
  2903.          each period, you move 1  or more new archives (ALSO  containing
  2904.          ZIP archives amongst others)  to this directory. You  only want
  2905.          to convert  these 1  or more  archives once,  without having to
  2906.          convert the other 20. This is  a normal problem on a BBS  where
  2907.          various archives are stored  in the upload-space and  the Sysop
  2908.          only wants to convert the newly uploaded archives.
  2909.  
  2910.          There are two  ways to do  it. One is  to use the  OnlyNewFiles
  2911.          option (see  later), but  this is  a very  primitive (but fast)
  2912.          way. The other is to use MTA's Archive Marking System <tm>.
  2913.  
  2914.          When AMS is active, MTA  will convert an archive and  after the
  2915.          conversion is finished,  MTA will add  a special string  at the
  2916.          end of the  archive. This string  is made up  with some special
  2917.          information that will be unique. When MTA runs again, the  file
  2918.          is read and MTA will detect that this string is present. If  it
  2919.          is, MTA will ignore the archive (unless AMS is switched off).
  2920.  
  2921.          If, for  some reason,  you want  to remove  the special string,
  2922.          you can run MTM (a support  utility in this package) to do  so.
  2923.          Also, when  you want  to start  using AMS  and you already have
  2924.          many converted  archives, you  can use  MTM to  add the  string
  2925.          (called the mark-string) to all these files, without having  to
  2926.          convert them.
  2927.  
  2928.          AMS will  be active  when NoMarked  is set  to on.  This option
  2929.          will instruct MTA to look if an archive contains a  mark-string
  2930.          and if so, if  it is the one  that you use on  your system. The
  2931.          mark-string can be created (and made unique) by yourself !
  2932.  
  2933.          All compressors  have been  tested with  this extra information
  2934.          appended and they seem to have no trouble with it. That is  not
  2935.          so strange if you  know that some communication  protocols will
  2936.          append binary  zeroes to  a file,  when transferred,  to fill a
  2937.          complete transfer block.
  2938.  
  2939.          A special word about  the mark-string information. If  everyone
  2940.          should use MTA's default and should download a file,  converted
  2941.          with MTA/NoMarked  and would  like to  convert this  file again
  2942.          with MTA/NoMarked, the file would be ignored. It is advised  to
  2943.          set your  own marker  with the  MarkString option  to something
  2944.          more or  less private.  BBS's could  enter their Node/Net/Point
  2945.          number or the name of the SysOp or something like  Ghostbuster,
  2946.          Snoopy or whatsoever.
  2947.  
  2948.          Another piece of advise. Many  BBS Sysop's like to convert  all
  2949.          files in the  upload-space to see  if there is  a virus inside.
  2950.          MTA is  perfect to  do that  job BUT  you must  be careful with
  2951.          your mark-string. If users can download archives from you  that
  2952.          contain the mark-string, they are able to upload archives  with
  2953.          a virus AND YOUR mark-string also. When this file is placed  in
  2954.          the upload-directory and you use the NoMarked option, MTA  will
  2955.          ignore the  archive because  it already  contains your mark-ID.
  2956.          You can use one of the following scenarios:
  2957.  
  2958.          - Use the  mark-string in the  upload directory conversion  but
  2959.            remove the  string (with  MTM) before  the file  is available
  2960.            for download (when moved to its own directory);
  2961.  
  2962.          - Don't use  the mark-string in  your upload-directory but  use
  2963.            it only in your normal directories;
  2964.  
  2965.          - Don't use the  mark-string in your upload-directory  (run MTM
  2966.            to remove any),  then convert the  file with NoMark  and move
  2967.            it at once to another directory. When MTA is used as an  exit
  2968.            to the  protocol-driver in  your BBS  (you can  use FileDoor,
  2969.            another DISP product, to do so), you can set up marking in  a
  2970.            save way  (convert ALL  archives that  are uploaded  and only
  2971.            convert  archives  that  are   not  marked  in  your   upload
  2972.            directory);
  2973.  
  2974.          NoMarked  has  no  meaning  when  using  /D  with  the AllFiles
  2975.          option.  The mark is not set when the MoveToDir option (/M)  is
  2976.          used.
  2977.  
  2978.  Relate: MoveToDir, /D, MarkString
  2979.  Dest. : All
  2980.  
  2981.  
  2982.  ┌─────────────────────────────────────────────────────────────────────┐
  2983.  │ MarkHeader [markstring]                                          (*)│
  2984.  └─────────────────────────────────────────────────────────────────────┘
  2985.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  2986.          already converted and which is  added to new archives when  the
  2987.          NoMarked option is set, is made up of two parts, the so  called
  2988.          header and  the actual  string). Both  have a  default but when
  2989.          you work with  the NoMarked option,  you should AT  LEAST alter
  2990.          the value of the  string and you COULD  alter the value of  the
  2991.          header also. If you  don't alter one or  both of them, it  will
  2992.          be  possible  that  someone  else  supplies an archive with the
  2993.          same values as  you use (because  they didn't alter  the header
  2994.          also).
  2995.  
  2996.          [markstring]  This must  be a  6 byte  long value  you want  to
  2997.                        assign to the  header. The default  is 3 times  a
  2998.                        binary zero and the  upper-case word MTA. If  you
  2999.                        supply less  than 6  bytes, the  header is filled
  3000.                        up to 6 bytes with spaces.
  3001.  
  3002.          If, for  some reason,  you change  [markstring] after  you have
  3003.          converted one  or more  archives with  the older  [markstring],
  3004.          you must run  MTM to convert  [markstring] to the  new value in
  3005.          those archives that have the old value.
  3006.  
  3007.  Relate: NoMarked, MarkString
  3008.  Dest. : All
  3009.  (*)   : Marked options are also in usage by: MTM
  3010.  
  3011.  
  3012.  ┌─────────────────────────────────────────────────────────────────────┐
  3013.  │ MarkString [string]                                              (*)│
  3014.  └─────────────────────────────────────────────────────────────────────┘
  3015.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  3016.          already converted and which is  added to new archives when  the
  3017.          NoMarked option is set, is made up of two parts, the so  called
  3018.          header and  the actual  string). Both  have a  default but when
  3019.          you work with  the NoMarked option,  you should AT  LEAST alter
  3020.          the value of the  string and you COULD  alter the value of  the
  3021.          header also. If you  don't alter one or  both of them, it  will
  3022.          be  possible  that  someone  else  supplies an archive with the
  3023.          same values as  you use (because  they didn't alter  the header
  3024.          also).
  3025.  
  3026.          [markstring]  This  must be a  14 byte long  value you want  to
  3027.                        assign to the string.  The default has the  value
  3028.                        'MTAYour ID here !'.  If you supply less  than 14
  3029.                        bytes, the string is  filled up to 14  bytes with
  3030.                        spaces.
  3031.  
  3032.          If, for  some reason,  you change  [markstring] after  you have
  3033.          converted one  or more  archives with  the older  [markstring],
  3034.          you must run  MTM to convert  [markstring] to the  new value in
  3035.          those archives that have the old value.
  3036.  
  3037.  Relate: NoMarked, MarkString
  3038.  Dest. : All
  3039.  (*)   : Marked options are also in usage by: MTM
  3040.  
  3041.  
  3042.  ┌─────────────────────────────────────────────────────────────────────┐
  3043.  │ UnMark                                                              │
  3044.  └─────────────────────────────────────────────────────────────────────┘
  3045.  Usage : Unmark  overrules  the   NoMark  option and should not be  used
  3046.          together with it. The option  is there for those special  cases
  3047.          where  an  archiver  is  not  able  to decompress a file with a
  3048.          mark-string at  the end.  The earlier  (older) LHA.EXE programs
  3049.          (2.0x series, the 2.1x series  work ok), would fail with  a CRC
  3050.          check when the  file was longer  than the length  calculated by
  3051.          LHA itself. This foolish option  is removed from LHA and  there
  3052.          is no current usage for the option.
  3053.  
  3054.  Relate: NoMarked, MarkHeader
  3055.  Dest. : All
  3056.  
  3057.  
  3058. │┌─────────────────────────────────────────────────────────────────────┐
  3059. ││ ExcludeFriendlyMark [markmask]                                      │
  3060. │└─────────────────────────────────────────────────────────────────────┘
  3061. │Usage : When your receive  files from a known BBS and that BBS has done
  3062. │        everthing  to  the archive  that you would normally do yourself
  3063. │        (the correct  virus-scanners,  the correct target format and so
  3064. │        on), you could  select to skip conversion of such files because
  3065. │        you are doing the same as the BBS has already done for you !
  3066. │
  3067. │        With  the  ExcludeFriendlyMark (up  to  10 of these options are
  3068. │        allowed), you can instruct MTA which files (in combination with
  3069. │        those files that  already  carry your own mark) can be skipped.
  3070. │        The only thing  that you must know, is the mark-string that the
  3071. │        BBS uses (the BBS must use marking to make this option work).
  3072. │
  3073. │        [markmask]    This  must be a  20 byte long  value you want  to
  3074. │                      use as the mask. Depending on the values that the
  3075. │                      BBS uses  (there  can be non-printable characters
  3076. │                      in use, when  the  MTA-default  is used), you can
  3077. │                      use the  '?'  wildcard on one or more placed. You
  3078. │                      can NOT  include  spaces in the mask ! Spaces can
  3079. │                      be replaced with a wildcard ('?');
  3080. │
  3081. │        An example:
  3082. │
  3083. │        ExcludeFriendlyMark ??????Rob?van.Hoeven
  3084. │
  3085. │        The first  6 characters  are  masked  because  they are the MTA
  3086. │        default X'00'  (6 times)  and  not  printable  characters.  The
  3087. │        space  between  'Rob' and 'van.Hoeven'  is  also masked because
  3088. │        there are no spaces allowed in the ExcludeFriendlyMark option.
  3089. │
  3090. │Relate: NoMarked, MarkHeader
  3091. │Dest. : All
  3092.  
  3093.  
  3094.  ┌─────────────────────────────────────────────────────────────────────┐
  3095.  │ OnlyNewFiles                                                        │
  3096.  └─────────────────────────────────────────────────────────────────────┘
  3097.  Usage : This  option  works   something  different  than  the  NoMarked
  3098.          option.  When set,  MTA will look for  a file FILES.MTA in  the
  3099.          directory where  the source-archives  are.   MTA will  read the
  3100.          date/time of this file and  EVERY file with a date/time  HIGHER
  3101.          than the date/time of FILES.MTA will be converted.  At the  end
  3102.          of the conversion, MTA will  set the dat/time of the  FILES.MTA
  3103.          to the current date and time.
  3104.  
  3105.          If no   FILES.MTA is   present, MTA   will assume   0 for  both
  3106.          the date   and  time   (resulting  in   a  conversion   of  ALL
  3107.          selected files)  and will  create the  file when  conversion is
  3108.          done.
  3109.  
  3110.  Relate: None
  3111.  Dest. : All
  3112.  
  3113.  ┌─────────────────────────────────────────────────────────────────────┐
  3114.  │ DelOldFiles [mm-yyyy] {action}                                      │
  3115.  │ DelOldFiles [-days]   {action}                                      │
  3116.  └─────────────────────────────────────────────────────────────────────┘
  3117.  Usage : MTA   is able to   do some maintenance   for you also.    Users
  3118.          with big  libraries  of   archives  would  like  to  clean some
  3119.          of the older  ones, once in  a  while.  Also, BBS SysOp's  like
  3120.          to  remove  uploaded  files   when  they   are  too   old. Most
  3121.          protocol drivers (also FileDoor) have   such options but   most
  3122.          of them  only look at the file date (FileDoor looks inside  the
  3123.          archive). With  MTA you can  assign a  file date  that  depends
  3124.          on the files inside the  archives  (see  later).  If  you   did
  3125.          so, you can  use this option  to clean your  library from older
  3126.          files.
  3127.  
  3128.          [mm-yyyy]     Is the  month (2 bytes,  use leading zeros)   and
  3129.                        yyyy is the year of the oldest files you want  to
  3130.                        KEEP in your library.  If the file date  is lower
  3131.                        than [mm-yyyy], MTA  will do something  with that
  3132.                        file,  depending  on  the  presence of the second
  3133.                        parameter and the DelOldPath option;
  3134.  
  3135.          [-days]       You can also use this syntax as a replacement for
  3136.                        [mm-yyyy]. In this case, you supply the number of
  3137.                        days  that  must  be  subtracted from the current
  3138.                        date. This new date  will now be the marking-line
  3139.                        and  older  files  are  considered 'too old'. You
  3140.                        must  supply  the minus sign and a number of days
  3141.                        (up to 32767)  that  must  be subtracted from the
  3142.                        current date.
  3143.  
  3144.          {action}      {action} can have the following values:
  3145.  
  3146.                        NONE  : MTA  will sound  the bell  (if NoBeep  is
  3147.                                not set and WarningTime is not zero)  and
  3148.                                will   give   a   warning.   The   actual
  3149.                                manipulation of the file will follow;
  3150.  
  3151.                        NOMSG : MTA will  not sound  the bell,  nor  will
  3152.                                there be any message;
  3153.  
  3154.                        ASK   : MTA will  ask the user if this file  must
  3155.                                be manipulated  or not.  The file  IS too
  3156.                                old  (otherwise  no  questions  will   be
  3157.                                asked)  but  it  allows  you  to manually
  3158.                                exclude  some  of  the  files  from   the
  3159.                                manipulation  that  will  follow. You can
  3160.                                answer 'Y'  or 'N'.  This parameter  must
  3161.                                not  be  used  when  you  want to run MTA
  3162.                                unattended.
  3163.  
  3164.          If the DelOldPath option is NOT  set and the file IS marked  as
  3165.          too old (either direct or  after a positive reply when  you use
  3166.          the  ASK  parameter),  MTA  will   DELETE  the  file.  If   the
  3167.          DelOldPath option IS set and the file IS marked, MTA will  MOVE
  3168.          the file to the directory assigned in the DelOldPath option.
  3169.  
  3170.  Relate: DelOldPath
  3171.  Dest. : All
  3172.  
  3173.  
  3174.  ┌─────────────────────────────────────────────────────────────────────┐
  3175.  │ DelOldPath [dir]                                                    │
  3176.  └─────────────────────────────────────────────────────────────────────┘
  3177.  Usage : If DelOldFiles  is set  and a  file is  marked as too old,  MTA
  3178.          will delete the file, unless you supply the DelOldPath  option.
  3179.          If this  option is  supplied, MTA  will MOVE  (not delete)  the
  3180.          file to the assigned directory.
  3181.  
  3182.          [dir]         This value must point to a valid  drive/directory
  3183.                        where the files  are moved to  when they are  too
  3184.                        old.  If  no drive is  supplied, the default  one
  3185.                        is  used.   Relative  directories  (..\WRKDIR and
  3186.                        such) are not  advised but can  be used (the  are
  3187.                        counted from the CURRENT directory).
  3188.  
  3189.  Relate: DelOldFiles
  3190.  Dest. : All
  3191.  
  3192.  
  3193. │┌─────────────────────────────────────────────────────────────────────┐
  3194. ││ SkipNewFiles [days]                                                 │
  3195. │└─────────────────────────────────────────────────────────────────────┘
  3196. │Usage : Where DelOldFiles will do something for files that are too old,
  3197. │        this option can  be  used  to  skip  files  that are too new to
  3198. │        convert.
  3199. │
  3200. │        [days]        This value must be set to the number of days that
  3201. │                      an archive can not be converted by MTA. Any value
  3202. │                      between 1 and 65535 is valid.
  3203. │
  3204. │        MTA will not  convert the files if the file-date/time is higher
  3205. │        than [currentdate]-[days]. This  can  be useful  when you don't
  3206. │        want to change archives for a certain number of days.
  3207. │
  3208. │Relate: None
  3209. │Dest. : All
  3210.  
  3211.  
  3212.  3.3.5 Statements that define the resulting files
  3213.  ───────────────────────────────────────────────────────────────────────
  3214.  MTA  includes  a  number  of  options  that  will  rule  the  resulting
  3215.  archives.   These include  optimizing the  files, the  comments to add,
  3216.  the files to add and remove from the archive and so on.
  3217.  
  3218.  ┌─────────────────────────────────────────────────────────────────────┐
  3219.  │ ExcludeFile [filemask]                                           (*)│
  3220. ││ ExcludeFile [filemask] {SUB}                                        │
  3221.  └─────────────────────────────────────────────────────────────────────┘
  3222.  Usage : Today there can be no archive that does not include some  files
  3223.          that have no relation with the actual archive but which  is/are
  3224.          added as some sort of advertisement. Every BBS adds, at  least,
  3225.          a comment in the  archive, so you can  read over and over  from
  3226.          which BBS the file came but there are also BBS Sysop's who  add
  3227.          files  to  the  archive  with  the same (or other) information.
  3228.          When I  had to  choose, I  would like  to see  NONE of the both
  3229.          ways (all the extra  bytes will cause longer  connections, thus
  3230.          costing money) but if  I had to choose  between one of them,  I
  3231.          would rather like to see included files than archive  comments.
  3232.          The included files are  compressed (thus costing less  transfer
  3233.          time)  but  the  comments  are  not  !  I wait for the day that
  3234.          SysOp's start to add  GIF's (640*480*256 or higher)  with their
  3235.          own  pictures.  In  that  case  we  all  can  have  fun when we
  3236.          download  an  archive  with  2   Kb  programs  and  300Kb   GIF
  3237.          advertisements !
  3238.  
  3239.          Normally, when you  obtain archives with  added advertisements,
  3240.          you would  like to  remove them  as soon  as possible. There is
  3241.          one thing positive about it, MOST SysOp's use the same name  of
  3242.          the  included  file(s)  over  and  over.  MTA  can remove these
  3243.          files, based  on their  name, AFTER  the decompression  AND the
  3244.          check for any virus. So  these files ARE included in  the check
  3245.          for a virus.
  3246.  
  3247.          [filemask]    The parameter must  contain a single   file-mask.
  3248.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3249.                        Also  a  special  wildcard  (=)  can be used. '='
  3250.                        will test  for a  shifting match.  So '=WAR' will
  3251.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3252.                        will NOT  match with  nodedifF.Zip. In  this case
  3253.                        you  must  use  =F.Z.   You  must  only include a
  3254.                        file-mask and not a directory and/or drive;
  3255.  
  3256. │        {SUB}         If you code  SUB  on  the ExcludeFile option, MTA
  3257. │                      will also look  into all sub-directories that are
  3258. │                      created by the  extraction. If  a  match is found
  3259. │                      in a sub-directory, MTA  will also remove it from
  3260. │                      the archive. If  the  parameter is NOT coded, MTA
  3261. │                      will only  look  in the relative 'root' directory
  3262. │                      of the archive.
  3263.  
  3264.          The  usage  of  the  '='  wildcard  can be handy when the SysOp
  3265.          alters the name of his/her  include file now and then.  In most
  3266.          cases you will see a range like this:
  3267.  
  3268.          JOHNDOE.ADD $JOHNDOE.ADD
  3269.          JOHNDOE$.ADD JOHNDOE.$$$
  3270.  
  3271.          It is a real  pain in the neck  and I can't see  the reason for
  3272.          doing so, but with =JOHNDOE for [filemask], you get rid of  all
  3273.          these files. Don't  use README or  READ.ME. If some  SysOp adds
  3274.          files like this as  an advertisement, they should  think twice.
  3275.          Most of the time, these files contain important info about  the
  3276.          package you have just obtained.
  3277.  
  3278.          You can use up to 255 (!) ExcludeFile statements in MTA.CTL.
  3279.  
  3280.  Relate: IncludeFile
  3281.  Dest. : All
  3282.  (*)   : Marked options are also in usage by: MTM
  3283.  
  3284. ExcludeFiles [mask] {SUB}
  3285.  
  3286. When the new SUB option is coded, MTA will also test if this mask will
  3287. match files in all SUB-directories that are extracted. If nothing is
  3288. supplied, only the root directory of the extracted files is tested;
  3289.  
  3290.  
  3291.  ┌─────────────────────────────────────────────────────────────────────┐
  3292.  │ IncludeFile [path] {newname} {CF$}                               (*)│
  3293.  └─────────────────────────────────────────────────────────────────────┘
  3294.  Usage : See  the  discussion   on  ExcludeFile. This option can do  the
  3295.          reversed. Where  ExcludeFile removes  any advertisement  files,
  3296.          IncludeFile can add your own advertisement !
  3297.  
  3298.          [path]        This value must point to a valid  drive/directory
  3299.                        and filename of the file to include. If no  drive
  3300.                        is supplied, the default  one is used.   Relative
  3301.                        directories (..\WRKDIR and such) are not  advised
  3302.                        but  can  be  used  (the  are  counted  from  the
  3303.                        CURRENT directory);
  3304.  
  3305.          {newname}     This optional  parameter can be  used to   change
  3306.                        the name of the  file assigned with [path]  as it
  3307.                        appears in  the archive.  For example,  if [path]
  3308.                        is   C:\COMMON\MYFILES.ASC   and   {newname}   is
  3309.                        JDOEBBS.ADD,  the  file  inside  the archive will
  3310.                        actually be called JDOEBBS.ADD. If you don't  use
  3311.                        the {newname} parameter, the file will be  called
  3312.                        MYFILES.ASC;
  3313.  
  3314.          {CF$}         This parameter is optional. When you use it,  the
  3315.                        {newname}  parameter  is  mandatory because {CF$}
  3316.                        MUST  be  the  third  parameter  !  When you code
  3317.                        CF$,  you  are  telling  MTA  that  the  file you
  3318.                        include is  in fact  an archive.   In this  case,
  3319.                        MTA will  convert the  included file  to the same
  3320.                        system as the target system for the archive.
  3321.  
  3322.          There can be up to 255 IncludeFile options in the MTA.CTL.  All
  3323.          files will be included  in EVERY converted extension.  When you
  3324.          leave  out  the  option,  nothing  is  included. I hope that no
  3325.          SysOp will use ALL 255 options for advertisement files.
  3326.  
  3327.  Relate: ExcludeFile
  3328.  Dest. : All
  3329.  (*)   : Marked options are also in usage by: MTM
  3330.  
  3331.  
  3332.  ┌─────────────────────────────────────────────────────────────────────┐
  3333.  │ TouchLow                                                            │
  3334.  └─────────────────────────────────────────────────────────────────────┘
  3335.  Usage : This parameter is optional and controls MTA's touching  system.
  3336.          When used, MTA touches (resets the compressed file's  time/date
  3337.          stamp) to  the lowest  date of  any file  inside the compressed
  3338.          file.  All  files  that  match  any supplied ExcludeFile option
  3339.          (see before)  are NOT  looked at.  As an  example, the  archive
  3340.          contains:
  3341.  
  3342.          A.A           12/31/91
  3343.          B.B           11/18/91
  3344.          C.C           01/01/92
  3345.          JOHNDOE.ADD   01/01/91
  3346.  
  3347.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3348.          of  the  ExcludeFile  options.  With  TouchLow set, the archive
  3349.          will get the  date 11/18/91 (JOHNDOE.ADD  has a lower  date but
  3350.          is not looked at).
  3351.  
  3352.          When TouchLow is set, TouchCur and  TouchHig  can  not be used.
  3353.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3354.          will retain the original file date/time;
  3355.  
  3356.  Relate: TouchCur, TouchHig, ChildTouch
  3357.  Dest. : All
  3358.  
  3359.  
  3360.  ┌─────────────────────────────────────────────────────────────────────┐
  3361.  │ TouchHig                                                            │
  3362.  └─────────────────────────────────────────────────────────────────────┘
  3363.  Usage : This parameter is optional and controls MTA's touching  system.
  3364.          When used, MTA touches (resets the compressed file's  time/date
  3365.          stamp) to the  highest date of  any file inside  the compressed
  3366.          file.  All  files  that  match  any supplied ExcludeFile option
  3367.          (see before)  are NOT  looked at.  As an  example, the  archive
  3368.          contains:
  3369.  
  3370.          A.A           12/31/91
  3371.          B.B           11/18/91
  3372.          C.C           01/01/92
  3373.          JOHNDOE.ADD   02/01/92
  3374.  
  3375.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3376.          of  the  ExcludeFile  options.  With  TouchHig set, the archive
  3377.          will get the date 01/01/92  (JOHNDOE.ADD has a higher date  but
  3378.          is not looked at).
  3379.  
  3380.          When TouchHig is set, TouchCur and  TouchLow  can  not be used.
  3381.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3382.          will retain the original file date/time;
  3383.  
  3384.  Relate: TouchCur, TouchLow, ChildTouch
  3385.  Dest. : All
  3386.  
  3387.  
  3388.  ┌─────────────────────────────────────────────────────────────────────┐
  3389.  │ TouchCur                                                            │
  3390.  │ TouchCur [+days]                                                    │
  3391.  └─────────────────────────────────────────────────────────────────────┘
  3392.  Usage : This parameter is optional and controls MTA's touching  system.
  3393.          When used, MTA touches (resets the compressed file's  time/date
  3394.          stamp) to the current date.
  3395.  
  3396.          When TouchCur is set, TouchHig and  TouchLow  can  not be used.
  3397.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3398.          will retain the original file date/time.
  3399.  
  3400.          A special format  is the usage of [+days]. If this parameter is
  3401.          present, MTA will  add  the  number of days that is supplied in
  3402.          this parameter to the  current  date and will touch all archives
  3403.          with that new date (comes in  handy when using a BBS and giving
  3404.          the new uploads a new date in the future).
  3405.  
  3406.          [+days]       This  value  must  be  set to a plus sign and the
  3407.                        number of days (up to 365)  to add to the current
  3408.                        date;
  3409.  
  3410.  Relate: TouchLow, TouchHig, ChildTouch
  3411.  Dest. : All
  3412.  
  3413.  
  3414.  ┌─────────────────────────────────────────────────────────────────────┐
  3415.  │ ChildTouch [type]                                                   │
  3416.  └─────────────────────────────────────────────────────────────────────┘
  3417.  Usage : Normally, MTA will use  the same type of touching for  archives
  3418.          inside  archives  (nested  arc-in-arc  files)  as  for the main
  3419.          archive. When this is  not what you want,  you can make use  of
  3420.          this ChildTouch  option to  overrule the  touching with another
  3421.          method for nested archives.
  3422.  
  3423.          [type]        You must either  supply HIGH, LOW, CUR or   FILE.
  3424.                        When HIGH is used,  touching on the highest  date
  3425.                        will  occur  for  nexted  archives,  LOW  for the
  3426.                        lowest date,  CUR for  the current  date and FILE
  3427.                        will cause the original  date to be retained  for
  3428.                        these nested archives.
  3429.  
  3430.          As an example, you can  touch all archives on current  date (so
  3431.          they will show as  new files on a  BBS) but it is  logical that
  3432.          this is not desired for archives inside archives. These  nested
  3433.          archives can be touched in another way if you include this  op-
  3434.          tion;
  3435.  
  3436.  Relate: TouchLow, TouchHig, TouchCur
  3437.  
  3438.  
  3439.  ┌─────────────────────────────────────────────────────────────────────┐
  3440.  │ IgnoreTimeComponent                                              (*)│
  3441.  └─────────────────────────────────────────────────────────────────────┘
  3442.  Usage : This  option  belongs   to  the previous TouchHig and  TouchLow
  3443.          options. When  you use  this option  (you don't  have to),  the
  3444.          time-component  of  the  date/time  of  every  file  inside the
  3445.          archive is ignored. Sometimes you need such an option when  you
  3446.          use software that use the  spare bit of the time/date  field in
  3447.          the  DOS  directory  entry.  There  are  some  programs   (some
  3448.          commercial  backup  programs)  that  do  so. When the option is
  3449.          set, all archives will get the time 00:00:00 when the  TouchHig
  3450.          or TouchLow option is active.
  3451.  
  3452.  Relate: TouchLow, TouchHig
  3453.  Dest. : All
  3454.  (*)   : Marked options are also in usage by: MTM
  3455.  
  3456.  
  3457.  ┌─────────────────────────────────────────────────────────────────────┐
  3458.  │ AcceptHighDate                                                   (*)│
  3459.  └─────────────────────────────────────────────────────────────────────┘
  3460.  Usage : Also this option belongs to the TouchHig and TouchLow  options.
  3461.          Sometimes archives  contain files  with dates  higher than  the
  3462.          current date. MTA  will give a  warning for each  of such files
  3463.          inside any archive because it could be possible that your  PC's
  3464.          date is not correctly set. If this is normal, or if you  expect
  3465.          to receive files with higher (invalid) dates, you must use  the
  3466.          AcceptHighDate option.  The actual  archive will  also get  the
  3467.          high date when TouchLow or TouchHig are in use.
  3468.  
  3469.  Relate: TouchLow, TouchHig
  3470.  Dest. : All
  3471.  (*)   : Marked options are also in usage by: MTM
  3472.  
  3473.  
  3474.  ┌─────────────────────────────────────────────────────────────────────┐
  3475.  │ NoArcInArc                                                          │
  3476.  └─────────────────────────────────────────────────────────────────────┘
  3477.  Usage : MTA will convert  any archives inside archives (in  this manual
  3478.          we call them arc-in-arc files)  up to ANY level deep  (but with
  3479.          respect to the conventional memory available).
  3480.  
  3481.          When running DOS 5.0 on 286, 386 or 486 machines, it is  normal
  3482.          to have  around 600.000  (or more)  bytes of  memory free. With
  3483.          this number of bytes free (and when swapping is used), you  can
  3484.          go up to 80  levels deep (I have  never seen such a  file). You
  3485.          need around 200K to run MTA itself and every MTA child uses  4K
  3486.          extra overhead for swapping.
  3487.  
  3488.          Normally you should  let MTA convert  any archives inside.  But
  3489.          if  memory  is  low,  or  speed  is  slow  or  disk-space  (for
  3490.          swapping)  is  low,  you  CAN  select to leave arc-in-arc files
  3491.          alone. In this case a  TEST.ZIP, containing a TEST.ARJ and  the
  3492.          target is  LZH, will  result in  TEST.LZH containing  TEST.ARJ.
  3493.          When  the  option  is  NOT  set,  it  will  result in TEST.LZH,
  3494.          containing TEST.LZH !
  3495.  
  3496.          For each level of arc-in-arc files, MTA will call itself to  do
  3497.          the  job  on  the  nested  archives,  thus  giving all possible
  3498.          options (with a few restrictions).
  3499.  
  3500.  Relate: None
  3501.  Dest. : All
  3502.  
  3503.  
  3504.  ┌─────────────────────────────────────────────────────────────────────┐
  3505.  │ OptimizeOnSize                                                      │
  3506.  └─────────────────────────────────────────────────────────────────────┘
  3507.  Usage : MTA can also be used to make the smallest possible archive.  It
  3508.          needs a  selection of  different archive  programs to  complete
  3509.          this job  and it  will convert  any archive  to the system that
  3510.          will result in  the smallest archive  (this creating a  mixture
  3511.          of a number of different target systems).
  3512.  
  3513.          All archivers  that are  included in  the xxxPath  options (see
  3514.          3.3.1, the  first options)  and that  have a  'Y' as the second
  3515.          parameter, will be used for testing.
  3516.  
  3517.          YOU must select which archivers  to include in the test.  There
  3518.          are some combinations (that can change when newer versions  hit
  3519.          the street) that are useful.  ZIP, ARJ, LZH and ZOO  (2.1x) can
  3520.          give a good  result. Including MD  or ARJ in  this list has  NO
  3521.          meaning. They ALWAYS result in a bigger archive, but the  given
  3522.          combination works.
  3523.  
  3524.          For  each  archive,  MTA  will  call the selected archivers and
  3525.          will start to  convert the archive  to each of  them (one after
  3526.          another,  only  taking  disk-space  for  one of them). When the
  3527.          smallest is known, MTA will AGAIN start the conversion but  now
  3528.          with ALL possible options (IncludeFile and such) active.
  3529.  
  3530.          OptimizeOnSize  will  cause  MTA  to  run  [number of archivers
  3531.          selected]+1 times longer (average) than normal. Only when  your
  3532.          space is limited, this option should be used !
  3533.  
  3534.  Relate: None
  3535.  Dest. : All
  3536.  
  3537.  
  3538.  ┌─────────────────────────────────────────────────────────────────────┐
  3539.  │ OnlyUpgrade                                                         │
  3540.  └─────────────────────────────────────────────────────────────────────┘
  3541.  Usage : This option can be  useful when you want to convert  your files
  3542.          to  a  higher  technical  level.  In  general, OnlyUpgrade will
  3543.          cause the following files  (also based on the  file-mask(s)) to
  3544.          convert to the new target:
  3545.  
  3546.          - Files  that are  not in  the target  format (e.g.  ZIP is the
  3547.            destination, so all non-ZIP files will be converted);
  3548.  
  3549.          - Files that ARE in the target format (e.g. ZIP and the  target
  3550.            is also ZIP) but that  have a LOWER TECHNICAL level  than the
  3551.            current target;
  3552.  
  3553.          The latter looks  somewhat difficult to  understand, so I  will
  3554.          come to the  point. ZIP, PAK  and LZH have  different levels of
  3555.          archives. You have the older  LZH 1.13 format but the  new 2.xx
  3556.          format is  different, you  have the  older PAK  (crushed) files
  3557.          and today we  have also a  new PAK format  (distilled). For ZIP
  3558.          the same rules apply.
  3559.  
  3560.          In plain english for each archiver involved:
  3561.  
  3562.          - If  the source  and target  are LZH  and the  source contains
  3563.            1.13 formatted  files, conversion  will be  done to  the 2.xx
  3564.            format with LHA;
  3565.  
  3566.          - If  the source  and target  are PAK  and the  source contains
  3567.            crushed  files,  conversion  will  be  done  to the destilled
  3568.            format with PAK;
  3569.  
  3570.          - If  the source  and target  are ZIP  and the  source contains
  3571.            either reduced 1-4 files  or imploded files, conversion  will
  3572.            be  done  to  the  ZIP  2.xx  deflated  format  (the previous
  3573.            versions of  MTA up  to 14.57  only did  an upgrade  from 1-4
  3574.            reduced to imploding, 15.01 will convert to deflated);
  3575.  
  3576.          If the source archive already  contains one or more files  from
  3577.          the NEW systems (f.i.  3 x stored but  1 x deflated), MTA  will
  3578.          not convert it when ZIP is also the target.
  3579.  
  3580.  Relate: ZIP, PAK, LZH
  3581.  Dest. : ZIP, PAK, LZH
  3582.  
  3583.  
  3584.  ┌─────────────────────────────────────────────────────────────────────┐
  3585.  │ AllDisketteFiles                                                    │
  3586.  └─────────────────────────────────────────────────────────────────────┘
  3587.  Usage : When you  use the  /D command-line  parameter (start   diskette
  3588.          conversion), MTA will only  convert archives on the  diskettes.
  3589.          If you  want to  move the  files to  another diskette (with the
  3590.          MoveToDir option) or you want to format the diskette (with  one
  3591.          of the exits),  you must make  sure that ALL  files are reMOVED
  3592.          from  the  diskette.  These  files  will  not  be converted but
  3593.          (temporary) moved to the same directory as where the  converted
  3594.          files are stored (temporary). You can instruct MTA to move  ALL
  3595.          files from the diskette (and back!) by setting this option.
  3596.  
  3597.          Diskette  conversion  is  not  possible  when  the  OnlyUpgrade
  3598.          option is set !
  3599.  
  3600.  Relate: EXITBeforeFill, EXITAfterFill, MoveToDir
  3601.  Dest. : All
  3602.  
  3603.  
  3604. │┌─────────────────────────────────────────────────────────────────────┐
  3605. ││ MakeArc [mask]                                                      │
  3606. │└─────────────────────────────────────────────────────────────────────┘
  3607. │Usage : MTA  is  able  to  convert  ANY NON-ARCHIVE file that is in the
  3608. │        working  directory  when  it  has  started to convert archives.
  3609. │        To  instruct  MTA  to  do such a thing, you must include one or
  3610. │        more MakeArc (and optionally MakeArcExclude) option(s).
  3611. │
  3612. │        [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3613. │                      filemask (up to 12 characters, wildcards allowed)
  3614. │                      of (a) non-archived file(s) that MTA must convert
  3615. │                      along the way;
  3616. │
  3617. │        MTA will convert all matching files to archives of the selected
  3618. │        target-type on a one-to-one basis. An example:
  3619. │
  3620. │        MakeArc *.*
  3621. │
  3622. │        MTA detects the following files in the working directory:
  3623. │
  3624. │        A.ZIP
  3625. │        B.ARJ
  3626. │        C.WAV
  3627. │        D.DOC
  3628. │        E.GIF
  3629. │        Z.ZOO
  3630. │
  3631. │        With a destination (target) of ZIP, the following will happen:
  3632. │
  3633. │        A.ZIP will be converted to  A.ZIP
  3634. │        B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3635. │        C.WAV  ,,  ,, archived into C.ZIP
  3636. │        D.DOC  ,,  ,, archived into D.ZIP
  3637. │        E.GIF  ,,  ,, archived into E.ZIP
  3638. │        Z.ZOO  ,,  ,, converted to  Z.ZIP
  3639. │
  3640. │        With  this example, MTA  will  archive every SINGLE file into a
  3641. │        SINGLE archive. There can be up to 255 MakeArc options.
  3642. │
  3643. │Relate: MakeArcExclude
  3644. │Dest. : All
  3645. │
  3646. │
  3647. │┌─────────────────────────────────────────────────────────────────────┐
  3648. ││ MakeArcExclude [mask]                                               │
  3649. │└─────────────────────────────────────────────────────────────────────┘
  3650. │Usage : This option  can be used in combination with the MakeArc option
  3651. │        and can  be  used to narrow the selection of non-archived files
  3652. │        that will be converted to an archive.
  3653. │
  3654. │        [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3655. │                      filemask (up to 12 characters, wildcards allowed)
  3656. │                      of (a) non-archived file(s) that MTA must exclude
  3657. │                      from the MakeArc process;
  3658. │
  3659. │        MTA  will  exclude  all matching files from the archive process
  3660. │        that is initialized by the MakeArc option(s). An example:
  3661. │
  3662. │        MakeArc *.*
  3663. │        MakeArcExclude *.GIF
  3664. │        MakeArcExclude *.WAV
  3665. │
  3666. │        MTA detects the following files in the working directory:
  3667. │
  3668. │        A.ZIP
  3669. │        B.ARJ
  3670. │        C.WAV
  3671. │        D.DOC
  3672. │        E.GIF
  3673. │        Z.ZOO
  3674. │
  3675. │        With a destination (target) of ZIP, the following will happen:
  3676. │
  3677. │        A.ZIP will be converted to  A.ZIP
  3678. │        B.ARJ  ,,  ,,    ,,     ,,  B.ZIP
  3679. │        C.WAV  ,,  ,, archived into C.WAP
  3680. │        D.DOC  ,,  ,, archived into D.ZIP
  3681. │        E.GIF  ,,  ,, left alone as E.GIF  <------------
  3682. │        Z.ZOO  ,,  ,, converted to  Z.ZIP
  3683. │
  3684. │        With this  example, MTA  will  archive every SINGLE file into a
  3685. │        SINGLE archive except GIF files !
  3686. │
  3687. │Relate: MakeArc
  3688. │Dest. : All
  3689.  
  3690.  
  3691.  ┌─────────────────────────────────────────────────────────────────────┐
  3692.  │ KeepAbnormalExtensions                                              │
  3693.  └─────────────────────────────────────────────────────────────────────┘
  3694.  Usage : Some of  the archives contain a  special extension that is  not
  3695.          common with the archive system. You can receive files with  the
  3696.          extension  .A25,  .SDN  and  so  on.  Normally MTA will convert
  3697.          these archives (unless excluded  by DoNot or the  file-mask) to
  3698.          a  new  archive  with  a  NORMAL  extension  (e.g. ZIP when you
  3699.          convert to ZIP). If you include this option, MTA will keep  the
  3700.          abnormal extension even after the conversion. So A.SDN (in  ZIP
  3701.          format), converted to ARJ, will still be called A.SDN.
  3702.  
  3703.          Only one archive system can not work with abnormal  extensions.
  3704.          DWC can only  work with archives  that end with  .DWC. When you
  3705.          convert A.SDN (in ZIP format) to DWC, the result will be  named
  3706.          A.DWC !
  3707.  
  3708.  Relate: None
  3709.  Dest. : All
  3710.  
  3711.  
  3712.  ┌─────────────────────────────────────────────────────────────────────┐
  3713.  │ WeekExtension [ext] [letter]                                        │
  3714.  └─────────────────────────────────────────────────────────────────────┘
  3715.  Usage : There are archives with a very special extension. These are the
  3716.          archives that (f.i.) contain the BBS-nodelist and BBS-nodediff
  3717.          files. These extensions are made up by a letter (normally a A)
  3718.          and two digits that are the last two digits of a day-number.
  3719.          In this manner, files with names like NODEDIFF.A21 can be found
  3720.          on various BBS's.
  3721.  
  3722.          There have been some proposals and standards as how to use these
  3723.          extensions for BBS-nodelist/nodediff files. As fas as I know,
  3724.          there is only one valid standard and that is the usage of ARC
  3725.          (SEA ARC, crunched) files with extension Axx (xx are the last
  3726.          two digits of the day-number). Some nets use other archivers
  3727.          for these files (like ZIP, ARJ and LZH). To keep a difference
  3728.          between these SEA ARC (Axx) files and those converted to any of
  3729.          the other systems, nets use different letters. As such the
  3730.          following list looks more or less standard (but is not covered
  3731.          by a formal fidonet-standard):
  3732.  
  3733.          SEA ARC         xxxxxxxx.Ann
  3734.          ZIP             xxxxxxxx.Znn
  3735.          ARJ             xxxxxxxx.Jnn
  3736.          LZH/LZS         xxxxxxxx.Lxx
  3737.  
  3738.          MTA can be used to maintain such a  system. Normally,  you  can
  3739.          supply   the  KeepAbnormalExtensions  option  to  maintain  the
  3740.          original extension of a file, but this would cause NODEDIFF.A10
  3741.          to keep  its original  extension  (A10)  even when  the file is
  3742.          actually converted to ZIP (Z10 would be better).
  3743.  
  3744.          You can  use  the  WeekExtension option(s) (up to 20) to inform
  3745.          MTA how  files  with the an extension made up by one letter and
  3746.          two  digits  (A01,  Z11, J18 and so on) should be (re)named. If
  3747.          you do not supply this option, MTA will either convert the name
  3748.          to a  normal  archive-extension or to the original extension if
  3749.          the  KeepAbnormalExtensions option is active. The WeekExtension
  3750.          option is set for the target-file !
  3751.  
  3752.          [ext]         This parameter must  be set to the NORMAL archive
  3753.                        extension  that  the  target-file would have been
  3754.                        given (like ZIP, ARJ, ARC and so on);
  3755.  
  3756.          [letter]      This  parameter  must be set to the letter of the
  3757.                        new  extension  that belongs to [ext] (like Z for
  3758.                        ZIP, L of LZH/LZS or J for ARJ).
  3759.  
  3760.          When  MTA  starts  converting an archive with an extension that
  3761.          is made  up  by  a letter and two numbers AND the new extension
  3762.          that the  archive  should  get under normal conditions (LZH for
  3763.          LHarc, ZIP  for  ZIP,  ARJ  for  ARJ and so on) is defined by a
  3764.          WeekExtension  option,  MTA  will  use  the supplied letter and
  3765.          will create  a  new extension with this letter and the original
  3766.          two digits. For example:
  3767.  
  3768.          WeekExtension ARC A
  3769.          WeekExtension ZIP Z
  3770.          WeekExtension LZH L
  3771.          WeekExtension LZS L
  3772.          WeekExtension ARJ J
  3773.  
  3774.          Source-archive  is  called  NODEDIFF.A12 and conversion is done
  3775.          to ZIP.  ZIP  is inside the array and 'owns' letter 'Z', so the
  3776.          new archive  will  be called NODEDIFF.Z12. Source is RA.H11 and
  3777.          conversion is  done  to ARJ. ARJ is in the array and 'owns' the
  3778.          letter 'J' so  the new archive is called RA.J11. Source archive
  3779.          is  called  DISP.J01  and conversion is done to HYPER. HYP (the
  3780.          extension  for  a normal HYPER archive) is NOT in the array so,
  3781.          unless  KeepAbnormalExtensions  is set, the new archive will be
  3782.          called DISP.HYP !
  3783.  
  3784.          Because  of the lack of rules for the conversion of extensions,
  3785.          MTA uses a 'dynamic' system.
  3786.  
  3787.  Relate: KeepAbnormalExtensions
  3788.  Dest. : All
  3789.  
  3790.  
  3791. │┌─────────────────────────────────────────────────────────────────────┐
  3792. ││ FixedConversion [mask] [target]                                     │
  3793. │└─────────────────────────────────────────────────────────────────────┘
  3794. │Usage : There can  be  up  to 255 of these options in MTA.CTL. For each
  3795. │        file  that  is  selected  for  processing, MTA  will look if it
  3796. │        matches  any [mask] in  the FIXEDCONVERSION option. If the name
  3797. │        matches  [mask] (the first  match will count), MTA will convert
  3798. │        the file  to  the [target] format EVEN if the default format is
  3799. │        something else.
  3800. │
  3801. │        [mask]        This must be a valid DOS (4DOS <tm> or DISP <tm>)
  3802. │                      filemask (up to 12 characters, wildcards allowed)
  3803. │                      that will have a fixed conversion;
  3804. │
  3805. │        [target]      This must be a valid name of the  target archiver
  3806. │                      (or convertor  in case  of  GIF-alike files). The
  3807. │                      valid names  are  the same as you supply with the
  3808. │                      COMPRESSIONTYPE  option (ZIP,  ARJ, ARC, ZOO, GIF
  3809. │                      and so on);
  3810. │
  3811. │        For example:
  3812. │
  3813. │        FixedConversion NODELIST.A?? ARC
  3814. │        FixedConversion NODEDIFF.A?? ARC
  3815. │
  3816. │        Will force  MTA to  convert  any selected file with one of that
  3817. │        names, to the  ARC  format, even  if the selected target-format
  3818. │        is ZIP.
  3819. │
  3820. │        This option comes in handy when certain files always have to be
  3821. │        converted to a fixed system.
  3822. │
  3823. │        All other options like WEEKEXTENSION and KEEPABNORMALEXTENSION
  3824. │        will still word.
  3825. │
  3826. │Relate: None
  3827. │Dest. : All
  3828.  
  3829.  
  3830.  ┌─────────────────────────────────────────────────────────────────────┐
  3831.  │ ReportSpecialAttributes                                             │
  3832. ││ ReportSpecialAttributes SKIP                                        │
  3833.  └─────────────────────────────────────────────────────────────────────┘
  3834.  Usage : Some archives  can contain files with  abnormal file-attributes
  3835.          like  HIDDEN,  READONLY  and/or  SYSTEM.  If  the decompression
  3836.          program is  able to  decompress these  files in  this way,  you
  3837.          could be in for trouble (though MTA will remove any left  files
  3838.          after the conversion). If you like to, MTA can report  archives
  3839. │        that contain such files when you set this option. Also, when
  3840. │        this option is set, MTA will reset all attributes that are not
  3841. │        'normal' (READONLY, HIDDEN and SYSTEM) before the new archive
  3842. │        is created.
  3843. │
  3844. │        When SKIP is supplied, MTA will not convert the attributes and
  3845. │        will not even convert the archive. The archive is moved to the
  3846. │        error-directory and conversion must be done by hand.
  3847.  
  3848.  
  3849.  Relate: None
  3850.  Dest. : All
  3851.  
  3852.  
  3853.  ┌─────────────────────────────────────────────────────────────────────┐
  3854.  │ ReportInvalidFiles                                                  │
  3855.  └─────────────────────────────────────────────────────────────────────┘
  3856.  Usage : It is  invalid  (and dangerous) when an archive contains one of
  3857.          more  files  with  a name equal to a device-name in your PC. To
  3858.          overcome any  problems  with  these archives, you should remove
  3859.          them !
  3860.  
  3861.          MTA is  (optionally)  able  to  test  EVERY filename inside the
  3862.          archive  against  ALL  CURRENT  device-driver  names  you  have
  3863.          active  in your  PC. If  you  set  this  option  (it  is highly
  3864.          recommened  that  you  do  so),  MTA  will perform these checks,
  3865.          otherwise  (no option)  it  won't.  Testing  of  all files will
  3866.          only take a few moments extra !
  3867.  
  3868.          In  general, only  when  this  option  will  cause  problems in
  3869.          your PC,  you  should  not  include  it, otherwise  include the
  3870.          option !
  3871.  
  3872.  Relate: None
  3873.  Dest. : All
  3874.  
  3875.  
  3876.  ┌─────────────────────────────────────────────────────────────────────┐
  3877.  │ KeepAV                                                              │
  3878.  └─────────────────────────────────────────────────────────────────────┘
  3879.  Usage : Both ARJ and ZIP can create archives with a special  attribute,
  3880.          called  the  security  envelope/Authentification  Verification.
  3881.          Normally these files are created by the original author of  the
  3882.          program(s) that are included and  the code functions as a  kind
  3883.          of proof that the file  is untouched by others (virus,  patches
  3884.          and so on). One piece of  bad luck is that some BBS's  also use
  3885.          the  AV/Security  Envelope  to  mark  these  files as 'theirs',
  3886.          destroying the original idea behind the AV/SE code.
  3887.  
  3888.          When you  want to  keep files  with a  valid AV/SE  as they are
  3889.          (and you should  do so, certainly  on a BBS),  you must include
  3890.          this option.  If MTA  detects such  an archive  it will  do the
  3891.          following:
  3892.  
  3893.          - Decompress the file
  3894.  
  3895.          - Test for any virus (still)
  3896.  
  3897.          - Perform the exists involved;
  3898.  
  3899.          - Remove all decompressed files;
  3900.  
  3901.          - Include any new files to the original file (only ZIP);
  3902.  
  3903.          - Add comments to the original file (only ZIP);
  3904.  
  3905.          - If the  source is an  SFX, it CAN  be converted to  a non-SFX
  3906.            file of the same system (when you set the SFXFiles option);
  3907.  
  3908.          The  original  archive  is  kept  as  it was. Only some special
  3909.          files could be added and, optionally a comment header (ZIP).
  3910.  
  3911.  Relate: IncludeAVFile
  3912.  Dest. : All
  3913.  
  3914.  
  3915.  ┌─────────────────────────────────────────────────────────────────────┐
  3916.  │ IncludeAVFile [filemask] {AVCode}                                   │
  3917.  └─────────────────────────────────────────────────────────────────────┘
  3918.  Usage : As you have read  in the previous option, there are  situations
  3919.          where the  AV/SE code  has NO  meaning whatsoever.  You can use
  3920.          this option to instruct MTA  WHICH AV/SE files must keep  their
  3921.          code. All  others will  be stripped  EVEN if  the KeepAV option
  3922.          forces MTA not to do so.
  3923.  
  3924.          [filemask]    The parameter must  contain a single   file-mask.
  3925.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3926.                        Also  a  special  wildcard  (=)  can be used. '='
  3927.                        will test  for a  shifting match.  So '=WAR' will
  3928.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3929.                        will NOT  match with  nodedifF.Zip. In  this case
  3930.                        you  must  use  =F.Z.   You  must  only include a
  3931.                        file-mask and not a directory and/or drive;
  3932.  
  3933.          {AVCode}      When this  parameter  is  NOT  present, all files
  3934.                        that  match  [filemask]  will  keep their AV-code
  3935.                        (e.g.  they  will  not be converted) if KeepAV is
  3936.                        set. You  can  also  supply  a  valid  AV-code or
  3937.                        AV-code-mask  overhere. In  this  case, all files
  3938.                        that  match  [filemask] AND  that  match {AVCode}
  3939.                        will  keep  their  AV-code (e.g. they will not be
  3940.                        converted)  when  KeepAV  is  set. You can either
  3941.                        supply  a  full  AV-code  overhere (like 0000 for
  3942.                        the  AV-code  that comes with original ARJxxx.EXE
  3943.                        distribution  file  or PKW655 that comes with the
  3944.                        original  PKLTExxx.EXE file)  or a mask. The mask
  3945.                        can  include  2  types of characters.  Either a #
  3946.                        (for numeric  digit)  or @ (for alphabetic digit)
  3947.                        can be  used in combination with real digits. For
  3948.                        example,  P@W###  will  cause  a match for PKW655
  3949.                        but NOT for P1WA11;
  3950.  
  3951.          Most obvious  you would  like to  keep the  AV/E codes for some
  3952.          general  files  like SCAN*.*, CLEAN*.*, 4DOS*.* and so on. Some
  3953.          examples are included in the archive. Some general hits:
  3954.  
  3955.          - When you want to keep all ZIP AV-codes, you can supply
  3956.            IncludeAVFile *.* @@@###
  3957.          - When you want to keep all ARJ AV-codes, you can supply
  3958.            IncludeAVFile *.* ####
  3959.          - Independent of the IncludeAVFile options you MUST set the
  3960.            KeepAV option to actually KEEP the AV-codes (e.g. no con-
  3961.            version of the archive). If there is a matching IncludeAVFile
  3962.            but NO KeepAV option, the archive will still be converted;
  3963.  
  3964.          There can be up to 512 IncludeAVFile options in MTA.CTL !
  3965.  
  3966. │Relate: KeepAV, ExcludeAVFile
  3967.  Dest. : All
  3968.  
  3969.  
  3970. │┌─────────────────────────────────────────────────────────────────────┐
  3971. ││ ExcludeAVFile [filemask] [AVCode] {KEEP│DELETE│MOVE}                │
  3972. │└─────────────────────────────────────────────────────────────────────┘
  3973. │Usage : This option works is  the reversed of the IncludeAVFiles option
  3974. │        described above. The  combination of In- and ExcludeAVFiles can
  3975. │        result in  a  very nifty  management of archives with AV-codes.
  3976. │        The number of ExcludeAVFile options that can be used is 512.
  3977. │
  3978. │        The  ExcludeAVFile  option  is  tested  AFTER  A MATCH from the
  3979. │        IncludeAVFile  is  found. If  it then matches the ExcludeAVFile
  3980. │        option, it  is  again  excluded  AV  operation an the AV is not
  3981. │        kept. If  you  did not use any IncludeAVFile (but KeepAV is set)
  3982. │        you can  still use this option. In this case ALL AV'ed archives
  3983. │        match (e.g. there  is  no  specific  IncludeAVFile) and you can
  3984. │        exclude them again with this option.
  3985. │
  3986. │        The  first  two  parameters for the ExcludeAVFile opion are the
  3987. │        same as those on the IncludeAVFile option.
  3988. │
  3989. │        The ExcludeAVFile  option  can use an extra parameter (when you
  3990. │        compare it  with  the IncludeAVFile option). This parameter can
  3991. │        have the following value:
  3992. │
  3993. │        KEEP   : KEEP is the  default  so it can be left out. When KEEP
  3994. │                 mode is  selected, MTA  will  leave  the AV'ed archive
  3995. │                 when it matches the ExcludeAVFile option in question;
  3996. │
  3997. │        MOVE   : When MOVE is used and the AV'ed archive will match the
  3998. │                 given  ExcludeAVFile  option, the file is MOVED to the
  3999. │                 error directory;
  4000. │
  4001. │        DELETE : When DELETE  is  used and the AV'ed archive will match
  4002. │                 the given  ExcludeAVFile  option,  the file is deleted
  4003. │                 from  the  disk. This  comes in handy when you want to
  4004. │                 remove  all  bogus-files  with a bogus-AVcode. Because
  4005. │                 both the  ARJ  and ZIP AV-codes are cracked, there are
  4006. │                 some  bogus  codes  in  the  circuit. If you know one,
  4007. │                 you  can  include  the  ExcludeAVFile  option for this
  4008. │                 AV-code, along with the DELETE option;
  4009. │
  4010. │        Example 1:
  4011. │
  4012. │        IncludeAVFile *.* ####            (include all ARJ's)
  4013. │        IncludeAVFile *.* @@@###          (include all ZIP's)
  4014. │        ExcludeAVFile *.* 0123    KEEP    (EXclude ARJ AV 123)
  4015. │
  4016. │        A file A.ZIP enters  with AV-code PKQ001. It matches the second
  4017. │        IncludeAVFile option  and does not match the ExcludeAVFile. Now
  4018. │        a B.ARJ with code  123 enters. This  file  matches the first of
  4019. │        the IncludeAVFile  options  but  also matches the ExcludeAVFile
  4020. │        option. It is kept as it was and no conversion will take place.
  4021. │
  4022. │        Example 2:
  4023. │
  4024. │        IncludeAVFile MT*.* RVH001
  4025. │        ExcludeAVFile M*.*  RVH001 DELETE
  4026. │
  4027. │        MTA_VXXX.ZIP  with AV-code  RVH001 enters. It matches MT*.* but
  4028. │        also M*.* and  is  deleted. Both  Include and exclude match but
  4029. │        the exclude is tested last and has a higher priority !
  4030. │
  4031. │Relate: KeepAV, IncludeAVFile
  4032. │Dest. : All
  4033.  
  4034.  
  4035.  ┌─────────────────────────────────────────────────────────────────────┐
  4036.  │ KeepVolLabel                                                        │
  4037.  └─────────────────────────────────────────────────────────────────────┘
  4038.  Usage : Both ARJ and ZIP can contain (optionally) a volume label.  This
  4039.          is  sometimes  used  for  ARJ/ZIP  files  that are a compressed
  4040.          image of a diskette.
  4041.  
  4042.          MTA uses some  special techniques to  enforce the volume  label
  4043.          inside a  ZIP or  ARJ (if  any). The  technique only works when
  4044.          you have the SubstDrive option set and is as follows:
  4045.  
  4046.          - The current  volume-label of the  substituted drive is  read.
  4047.            This is the same label  as the drive containing the  ORIGINAL
  4048.            directory that is now used  for the substitution (in fact  it
  4049.            IS the volume label of that drive);
  4050.  
  4051.          - The ARJ or  ZIP is read. If  it contains no volume-label,  it
  4052.            will be converted as normal;
  4053.  
  4054.          - If it  contains a volume-label,  MTA will decompress  it with
  4055.            the option to decompress the volume-label as well;
  4056.  
  4057.          - The target system will  be called to compress the  file again
  4058.            (if it supports volume-labels,  those options are also  added
  4059.            by MTA);
  4060.  
  4061.          - MTA will reset  the volume-label to the original value unless
  4062.            there was no previous value, in which case MTA will set the
  4063.            label to MTA TMP LBL;
  4064.  
  4065.  Relate: None
  4066.  Dest. : ZIP, ARJ
  4067.  
  4068.  
  4069.  ┌─────────────────────────────────────────────────────────────────────┐
  4070.  │ SkipBackups                                                         │
  4071.  └─────────────────────────────────────────────────────────────────────┘
  4072.  Usage : Both ARJ and ZOO can contain (optionally) backups. These  files
  4073.          are normally not  decompressed by MTA  and will be  lost unless
  4074.          you have set special options for both ARJ and ZOO.
  4075.  
  4076.          If you want  to keep the  backups, you can  force MTA to  leave
  4077.          this archives as they were. In fact, they are skipped when  you
  4078.          supply this option  ! Normal ARJ/ZOO  files that DON'T  contain
  4079.          backup versions are processed as before.
  4080.  
  4081.  Relate: None
  4082.  Dest. : ZOO, ARJ
  4083.  
  4084.  
  4085.  ┌─────────────────────────────────────────────────────────────────────┐
  4086.  │ OverwriteDuplicates                                                 │
  4087.  └─────────────────────────────────────────────────────────────────────┘
  4088.  Usage : Normally  MTA will never  overwrite any duplicate  file. If you
  4089.          convert A.ZIP  and A.ARJ  to ZOO,  it will  result in A.ZOO and
  4090.          A.ZO1 (the second  archive will be  renamed but will  NOT erase
  4091.          the other). If you  supply the OverwriteDuplicates option,  MTA
  4092.          WILL overwrite any file with the same name. This also goes for
  4093.          files that are moved to the error-directory and/or the trashcan
  4094.          directory !
  4095.  
  4096.  Relate: None
  4097.  Dest. : All
  4098.  
  4099.  
  4100.  ┌─────────────────────────────────────────────────────────────────────┐
  4101.  │ Description                                                         │
  4102.  └─────────────────────────────────────────────────────────────────────┘
  4103.  Usage : Most archivers have the  option to add a description to  one or
  4104.          more (or all)  components inside the  archive. If you  set this
  4105.          option, MTA  will add  options for  the target  to ask for such
  4106.          comments. THIS IS MANUAL WORK,  DON'T USE THIS OPTION WHEN  MTA
  4107.          MUST RUN UNATTENDED !!
  4108.  
  4109.  Relate: Autodescription
  4110.  Dest. : All
  4111.  
  4112.  
  4113.  ┌─────────────────────────────────────────────────────────────────────┐
  4114.  │ Autodescription [path]                                           (*)│
  4115.  └─────────────────────────────────────────────────────────────────────┘
  4116.  Usage : When you want to include a comment header in your target  file,
  4117.          you can use this option to do so (automatically). Those  target
  4118.          systems that  support it,  will be  instructed to  add a common
  4119.          header  to  each  and  every  converted  archive. Currently the
  4120.          comment can be added to ZIP, ZOO, ARJ and PAK files.
  4121.  
  4122.          [path]        This value must point to a valid  drive/directory
  4123.                        and  filename  of  the  file  which  include  the
  4124.                        actual comment.   If no  drive is  supplied,  the
  4125.                        default  one  is   used.   Relative   directories
  4126.                        (..\WRKDIR and such) are  not advised but can  be
  4127.                        used   (the   are   counted   from   the  CURRENT
  4128.                        directory).    The   file   must   be   a  normal
  4129.                        text-file. It can be a ANSI file (not  preferred,
  4130.                        most  archivers   won't  display   ANSI-sequences
  4131.                        unless specifically told, because ANSI  sequences
  4132.                        can  reconfigure  the  key-  board.  You would be
  4133.                        surprises and angry to  see that F3 now  starts a
  4134.                        FORMAT  of  your  hard-disk),  but  a normal pain
  4135.                        ASCII file  is best.  The total  size can  not be
  4136.                        greater than 64000 bytes.
  4137.  
  4138.          The AutoDescription can also be combined with the  CarryComment
  4139.          option (see BBS options) to gain maximum result !
  4140.  
  4141.          MTA uses the quickest  but safest way to  add the comment to  a
  4142.          file. In most cases piping  will be used (PKZIP -z  A <comment)
  4143.          but sometimes special options.
  4144.  
  4145.  Relate: Description
  4146.  Dest. : ARJ, ZIP, ZOO, PAK
  4147.  (*)   : Marked options are also in usage by: MTM
  4148.  
  4149.  
  4150.  3.3.6 Your own (new) compressor
  4151.  ───────────────────────────────────────────────────────────────────────
  4152.  The following  statements can  be used  to define  a compressor that is
  4153.  not (yet)  included in  MTA. If  you find  a compressor  that meets the
  4154.  standard to be included into MTA then please contact the author.
  4155.  
  4156.  Your OWN compression and decompression programs must follow some  basic
  4157.  rules and it is only needed to  include them if they are not yet  added
  4158.  to the STANDARD MTA support. The following rules apply:
  4159.  
  4160.  - They must report an errorlevel higher than 0 if errors occur;
  4161.  
  4162.  - The first errorlevel that reports  an error can not be followed  by a
  4163.    higher errorlevel that does NOT report an error;
  4164.  
  4165.  - The compressor MUST have an  option to delete the files it  has added
  4166.    to the archive;
  4167.  
  4168.  - The decompressor CAN have  recursive support. This also goes  for the
  4169.    compressor. It is not mandatory;
  4170.  
  4171.  - You can NOT use a batch-file to call the compressor/decompressor;
  4172.  
  4173.  - The  compression  system  must  use  its  own  extension (CRA in  the
  4174.    following examples);
  4175.  
  4176.  - Sometimes  you can  use the  support for  OWN compressors to overrule
  4177.    the  normal  compression/decompression  programs  that  MTA  supports
  4178.    internally, but you are on your own;
  4179.  
  4180.  
  4181.  ┌─────────────────────────────────────────────────────────────────────┐
  4182.  │ OwnCompressPath   [path] {opt} {DynSwapSiz} {second path}           │
  4183.  │ OwnDeCompressPath [path] {opt} {DynSwapSiz} {second path}           │
  4184.  └─────────────────────────────────────────────────────────────────────┘
  4185.  Usage : For your own  compression and decompression program, these  two
  4186.          statements must  be included.  The syntax  is the  same as  all
  4187.          other  xxxPath  options.  OwnCompressPath and OwnDecompressPath
  4188.          must point  to the  same file  if compression/decompression  is
  4189.          combined in one program.
  4190.  
  4191.  Relate: All Own-options
  4192.  Dest. : OWN
  4193.  
  4194.  
  4195.  ┌─────────────────────────────────────────────────────────────────────┐
  4196.  │ OwnCompressCall   [parms2use]                                       │
  4197.  │ OwnDeCompressCall [param2use]                                       │
  4198.  └─────────────────────────────────────────────────────────────────────┘
  4199.  Usage : When  using a customized  compression program, you  must supply
  4200.          the  parameters  to  be  passed  to  this program in the option
  4201.          OwnCompressCall.  For  any  decompression,  you must supply the
  4202.          parameters in the OwnDecompressCall option.
  4203.  
  4204.          [parms2use]   This parameter  must be  set in  a way  that  the
  4205.                        following sequence is started for compression:
  4206.  
  4207.                        - Compress all files in the current directory  in
  4208.                          the new archive;
  4209.  
  4210.                        - Delete all files from the current directory  or
  4211.                          compress with a move option (implicit delete);
  4212.  
  4213.                        This  parameter  must  be  set  in a way that the
  4214.                        following sequence is started for decompression:
  4215.  
  4216.                        - DeCompress all  files in the  current directory
  4217.                          from  the  new  archive;  The  name  of the new
  4218.                          archive is included  at the location  where you
  4219.                          add %1 in this parameter.
  4220.  
  4221.  Relate: All Own-options
  4222.  Dest. : OWN
  4223.  
  4224.  
  4225.  ┌─────────────────────────────────────────────────────────────────────┐
  4226.  │ OwnCompressLowErrorRC   [errornumber]                               │
  4227.  │ OwnDecompressLowErrorRC [errornumber]                               │
  4228.  └─────────────────────────────────────────────────────────────────────┘
  4229.  Usage : When  you  include   a  customized (de)compressor, you have  to
  4230.          supply the  LOWEST DOS  errorlevel given  by the (de)compressor
  4231.          when something is WRONG.
  4232.  
  4233.          [errornumber] This  parameter  must  be  the lowest  errorlevel
  4234.                        returned  by  the  (de)compression  program  when
  4235.                        something is wrong. Values must be between 1  and
  4236.                        255;
  4237.  
  4238.  Relate: All Own-options
  4239.  Dest. : OWN
  4240.  
  4241.  
  4242.  ┌─────────────────────────────────────────────────────────────────────┐
  4243.  │ OwnExtension [extension]                                            │
  4244.  └─────────────────────────────────────────────────────────────────────┘
  4245.  Usage : When  you want MTA  to 'see' your  customized compressed files,
  4246.          you have to supply  the name of the  extension MTA has to  look
  4247.          for. This can only be 1 extension (e.g. OWN).
  4248.  
  4249.          [extension]   This parameter must  be the (up to 3 bytes  long)
  4250.                        extension of the compressed files that are  ruled
  4251.                        under the OWN options.
  4252.  
  4253.          For every file that confirms to the supplied file-mask(s),  MTA
  4254.          will FIRST look if it  has an 'OwnExtension'. In that  case MTA
  4255.          will decompress  the file  with the  supplied decompressor.  If
  4256.          the destination is OWN, MTA instruct the customized  compressor
  4257.          to create files with extension 'OwnExtension'.
  4258.  
  4259.  Relate: All Own-options
  4260.  Dest. : All, including source OWN
  4261.  
  4262.  
  4263.  ┌─────────────────────────────────────────────────────────────────────┐
  4264.  │ OwnRecursive                                                        │
  4265.  └─────────────────────────────────────────────────────────────────────┘
  4266.  Usage : When you implement a  compressor, you have to tell MTA  if that
  4267.          compressor  is  capable  of  handling  recursive  support. This
  4268.          means that  the compressor  will look  in the  current and  all
  4269.          lower directories. If the customized compressor can not  handle
  4270.          recursive support, you must leave out this option out.
  4271.  
  4272.  Relate: All Own-options
  4273.  Dest. : OWN
  4274.  
  4275.  
  4276.  3.3.7 Statements that define the various exits (hooks) in MTA
  4277.  ───────────────────────────────────────────────────────────────────────
  4278.  The following statements can be used  to define one or more exits.  The
  4279.  exit points in MTA  can be used to  call other programs, before,  while
  4280.  or after  the compression  and/or start  and end  of MTA.  Some of  the
  4281.  exits like the  VirusScanner option are  advised, the others  are up to
  4282.  you !
  4283.  
  4284.  ┌─────────────────────────────────────────────────────────────────────┐
  4285. ││ VirusScanner [desc] [crt] [swap] [lowe] {highe} [path] [parm] {parm}│
  4286.  └─────────────────────────────────────────────────────────────────────┘
  4287.  Usage : One of the major topics  on the PC today is the virus.  MTA has
  4288.          specific support for the scan  for a virus. The scanning  (when
  4289.          active) is done  after the decompression  of the files  (before
  4290.          the removal of any files that match any ExcludeFile option).
  4291.  
  4292.          Which scanner(s) you want  to use is fully  up to you. MTA  can
  4293.          support  a  wide  range  of  scanners.  MTA  is tested with the
  4294.          following scanners  (examples for  their calls  are included in
  4295.          the sample MTA.CTL inside the distribution archive):
  4296.  
  4297.          - Scan     by McAfee <tm>
  4298.          - TBScan   by Frans Veldman <tm>
  4299.          - HTScan   by Harry Thijssen <tm>
  4300.          - VIRX     by Microcom Software Division <tm>
  4301.          - CPAV     by Central Point Software <tm> (Version 1.2 and up)
  4302.          - FINDVIRU by S&S International <tm> (Dr. Solomon)
  4303.  
  4304.          With  the  current   version  of  MTA,   up to 10 scanners  can
  4305.          be  included.  If  a  file  contains   a  virus, the archive is
  4306.          moved to  the error-directory  and marked  with special  0-byte
  4307.          files.  Also  further processing of  THIS file   is aborted and
  4308.          MTA will  start working on the next archive.
  4309.  
  4310. │        [desc]        This must  be a  short description of the type of
  4311. │                      scanner. It will be displayed in the MTA log-file
  4312. │                      and  remote  when  MTA is  doing its work under a
  4313. │                      protocol  driver like FileDoor <tm>. It can be up
  4314. │                      to 40 bytes  and  spaces  must  be substituded by
  4315. │                      underscore characters ('_');
  4316.  
  4317.          [crt]         You must  either supply   'B' or  'D'. If     the
  4318.                        scanner is BIOS  oriented (line-mode) and  can be
  4319.                        run in the  MTA window, you  can use 'B'.  If the
  4320.                        scanner is using direct video calls/running  full
  4321.                        screen, you  must supply  'D'. MTA  will preserve
  4322.                        the screen according to this option;
  4323.  
  4324.          [swap]        This must  be the  amount of  memory (in  Kbytes)
  4325.                        that  must  be  available  to  run  the   scanner
  4326.                        without MTA having to swap itself out of  memory.
  4327.                        The  examples  in  the  supplied MTA.CTL are good
  4328.                        ones and used while testing;
  4329.  
  4330.          [lowe]        This must be the errorlevel the scanner   returns
  4331.                        when  a  virus  is  found.  Most scanners use the
  4332.                        errorlevel 1 when a virus is found, some of  them
  4333.                        use  a  range.  Check  the  documentation  of the
  4334.                        scanner to make sure you supply the right  level.
  4335.                        The  examples  in  MTA.CTL  are  correct  for the
  4336.                        given scanners;
  4337.  
  4338.          {highe}       This parameter is optional. If the scanner   will
  4339.                        return a  range of  errorlevels when  a virus  is
  4340.                        involved  (HTScan  does),  you  must  supply  the
  4341.                        lower limit  in [lowe]  and the  higher limit  in
  4342.                        {highe}.   If you  don't supply  {highe}, it will
  4343.                        be set  to the  same value  as [lowe].  The given
  4344.                        examples  in  MTA.CTL  are  correct for the given
  4345.                        scanners;
  4346.  
  4347.          [Path]        This parameter must contain the drive,  directory
  4348.                        and  filename  of  the  scanner  in question. MTA
  4349.                        will  validate  if  the  program  is at the given
  4350.                        location and give a warning if it isn't;
  4351.  
  4352.          [parm] {parm} At  this  location   you  can  (must) supply  the
  4353.                        various parameters for  the scanner. There  are a
  4354.                        few macros  available  that  will  be replaced by
  4355.                        values at run-time. These are:
  4356.                        %P This macro will be replaced with the full name
  4357.                           of the HIGHEST directory in the tree where the
  4358.                           decompressed files reside;
  4359.                        %F Will do the same but  will  show a \*.* behind
  4360.                           the directory;
  4361.                        %D This macro will be replaced with the LAST node
  4362.                           in the directory  tree.  For  example, if  the
  4363.                           directory is E:\TUP\TST\1F6566A6, %D  will  be
  4364.                           replaced by 1F6566A6. This comes in handy  for
  4365.                           scanners that make problems in networks;
  4366.                        %L This macro will be replaced by the driveletter
  4367.                           and a colon (C:, E: and so on). Some  scanners
  4368.                           can only work on drives and not on directories
  4369.                           only;
  4370.                        %S This is a better replacement for %L.  It  will
  4371.                           be subtituded with the driveletter (and colon)
  4372.                           of the SUBSTituted drive (only  when  you  use
  4373.                           the SUBST support,  which  is  advised).  Only
  4374.                           when the scanner has  problems  with  a  SUBST
  4375.                           drive you should use %L. If you don't use  the
  4376.                           SUBST support of MTA, %S will be replaced with
  4377.                           the normal drive (as with %L);
  4378.  
  4379.          Never forget to  check if the  scanner will halt  for a prompt.
  4380.          If this is the  case and you run  unattended, you could have  a
  4381.          problem. If you  run attended, this  makes no difference.  Most
  4382.          scanners implement  a type  of 'No-prompt'  mode, like /NOPAUSE
  4383.          with SCAN.  Be sure  to set  it somewhere  in [parm] or {parm}.
  4384.          Also do not forget to  implement the option to check  ALL lower
  4385.          trees  under  the  directory  that  is tested. The scanner must
  4386.          also scan all sub-directories.
  4387.  
  4388.          Examples for the mentioned  scanners are included (and  tested)
  4389.          in the example MTA.CTL in the distribution archive.
  4390.  
  4391.  Relate: VirusMasks
  4392.  Dest. : All
  4393.  
  4394.  
  4395.  ┌─────────────────────────────────────────────────────────────────────┐
  4396.  │ VirusMasks [mask1] {mask2}..{mask10}                                │
  4397.  └─────────────────────────────────────────────────────────────────────┘
  4398.  Usage : Normally when you supply one or  more VirusScanner options, MTA
  4399.          will ALWAYS call all  virus-scanners for every  archive that is
  4400.          converted. This can be a pain in the neck when you have lots of
  4401.          files that don't contain  files that can carry a virus. If this
  4402.          is the case, or you want  to limit the testing of viri for some
  4403.          other reason, you  can  supply this VirusMasks option. With the
  4404.          option you can  supply  1 to 10 different file-masks. If one or
  4405.          more of  these  file-masks  match files inside the archive that
  4406.          is converted, MTA  will  call the virus-scanners. If no file in
  4407.          the archive matches  any of the masks that you supply with this
  4408.          option, the virus-scanners are NOT called !
  4409.  
  4410.          [mask1]       This parameter must be a valid file-mask. You can
  4411.            \\          also use the DISP-compatible format (=value). You
  4412.          {mask10}      must supply at  least  one mask when you use this
  4413.                        option and  you  can supply to a maximum of 10 of
  4414.                        these masks. In  normal  situations you will only
  4415.                        supply  extensions  like (*.COM, *.EXE, *.OVR and
  4416.                        *.SYS)  but  it  IS  possible to trigger the scan
  4417.                        on a full file-mask (like AVIRUS.COM).
  4418.  
  4419.          When you do NOT supply this option but you have supplied one or
  4420.          more  VirusScanner  options, the scan is ALWAYS performed. Only
  4421.          when the VirusMasks option is present, the scan will be limited
  4422.          to those archives that contain one or more match !
  4423.  
  4424.  Relate: VirusScanner
  4425.  Dest. : All
  4426.  
  4427.  
  4428.  ┌─────────────────────────────────────────────────────────────────────┐
  4429.  │ EXITBeforeStart       {dynswapsiz} [path] {option}...{option}       │
  4430.  │ EXITBeforeEnd         {dynswapsiz} [path] {option}...{option}       │
  4431.  │ EXITBetweenConversion {dynswapsiz} [path] {option}...{option}       │
  4432.  │ EXITAfterCompression  {dynswapsiz} [path] {option}...{option}       │
  4433.  │ EXITBeforeFill        {dynswapsiz} [path] {option}...{option}       │
  4434.  │ EXITAfterFill         {dynswapsiz} [path] {option}...{option}       │
  4435.  └─────────────────────────────────────────────────────────────────────┘
  4436.  Usage : These options  include the  support for  various user exits  at
  4437.          various  places  in  MTA.  You   can  instruct  MTA  to call  a
  4438.          program OR a batch-file  (normally batch-files are not  allowed
  4439.          but  they  are  for   these  exits).   All  options  have these
  4440.          parameters in common:
  4441.  
  4442.          {dynswapsiz]} This  can  be  the  amount of memory (in  Kbytes)
  4443.                        that  must  be  available  to  run  the   scanner
  4444.                        without MTA having to swap itself out of  memory.
  4445.                        You  can  also  leave   out  the  parameter   (no
  4446.                        swapping);
  4447.  
  4448.          [Path]        This parameter must contain the drive,  directory
  4449.                        and filename  of the  exit in  question. MTA will
  4450.                        not validate  if they  are present  but will fail
  4451.                        the exit (but continue) if they are not. You  can
  4452.                        either supply a program or a batch-file.
  4453.  
  4454.          {option}      You can include various parameters that  will  be
  4455.                        passed  to  the  called  program/batch over here.
  4456.                        For some  options there  are special  macros (see
  4457.                        below) that can be used.
  4458.  
  4459.          Some of the exits can  contain macros inside the {option}  part
  4460.          of the call, these are:
  4461.  
  4462.          %1   This parameter can  occur anywhere in  {option}. MTA  will
  4463.               substitute  this  parameter  with  the relative path where
  4464.               the  uncompressed  files  are.  This  parameter is in fact
  4465.               superfluous, because  you ARE  in this  directory when the
  4466.               call  to   the  exit   is  made   (only  valid   for   the
  4467.               ExitBetweenConversion and ExitAfterCompression exits);
  4468.  
  4469.          %2   MTA will substitute this parameter with the name (not  the
  4470.               extension) of  the compressed  file (to  be) created (only
  4471.               valid     for      the      ExitBetweenConversion      and
  4472.               ExitAfterCompression exits);
  4473.  
  4474.          %3   MTA will  substitute this  parameter with  the   extension
  4475.               (without  the  point,  so  LZH   and  not  .LZH)  of   the
  4476.               compressed file (to be) created.  Can be used to test  the
  4477.               target  type  in  most  situations  (only  valid  for  the
  4478.               ExitBetweenConversion and ExitAfterCompression exits);
  4479.  
  4480.          %T   MTA will substitute this parameter with the number of  the
  4481.               MTA-task (see  /TASK) that  is running.  When no  /TASK is
  4482.               supplied, %T  will be  replaced by  1. This  macro can  be
  4483.               used to assign different exits for different tasks;
  4484.  
  4485.          You can take  a look into  the supplied example  of batch-files
  4486.          that are present inside the distribution archive.
  4487.  
  4488.          The various exits are called in the following phases:
  4489.  
  4490.          ExitBeforeStart              Called once, after reading     the
  4491.                                       MTA.CTL   file   and   before  the
  4492.                                       actual conversion. Can be used  to
  4493.                                       (re)set the cache  (if any) or  to
  4494.                                       sort directories and so on;
  4495.  
  4496.          ExitBeforeEnd                Called once, after the  conversion
  4497.                                       and  just  before  the termination
  4498.                                       of  MTA.  Can  be  used to reverse
  4499.                                       the actions in ExitBeforeStart  or
  4500.                                       anything else;
  4501.  
  4502.          ExitBetweenConversion        Called after every decompress  and
  4503.                                       before the  actual compress  takes
  4504.                                       place.  Can  be  used  to  perform
  4505.                                       special     actions     on     the
  4506.                                       decompressed files that MTA  can't
  4507.                                       do for you;
  4508.  
  4509.          ExitAfterCompression         Called after every final  compress
  4510.                                       of a file. Can be used to  perform
  4511.                                       actions  on  the  new archive that
  4512.                                       MTA can't do;
  4513.  
  4514.          ExitBeforeFill               Only called when /D is used.   Can
  4515.                                       be used to  do something with  the
  4516.                                       empty  diskette  that  is going to
  4517.                                       be filled  with files.  An example
  4518.                                       is to (re)format such a  diskette.
  4519.                                       Exit   is    called   for    every
  4520.                                       converted diskette;
  4521.  
  4522.          ExitAfterFill                Only called when /D is used.   Can
  4523.                                       be used to  do something with  the
  4524.                                       newly filled diskette. An  example
  4525.                                       is to catalogue  all files on  the
  4526.                                       diskette   with   your    favorite
  4527.                                       catalogue program. Exit is  called
  4528.                                       for every converted diskette;
  4529.  
  4530.          As said before, there  are some example batch-files  inside the
  4531.          distribution archive.
  4532.  
  4533.  Relate: All of MTA
  4534.  Dest. : Any
  4535.  
  4536.  
  4537.  
  4538.  3.3.8 Statements that are useful to Bulletin Board Systems and SysOps
  4539.  ───────────────────────────────────────────────────────────────────────
  4540.  MTA can  be useful  for normal  user and  also for  SysOp's of Bulletin
  4541.  Board Systems (BBS). There are  several options that involve the  daily
  4542.  operation of archives inside a BBS.
  4543.  
  4544.  ┌─────────────────────────────────────────────────────────────────────┐
  4545.  │ QBBSPaths [areafile] {ver}                                          │
  4546.  └─────────────────────────────────────────────────────────────────────┘
  4547.  Usage : If you change your file  areas once in a while, you can  decide
  4548.          to  use  another  source  for   MTA  than  the  usage  of   the
  4549.          DefaultPath option. If you  use the QBBSPaths option,  MTA will
  4550.          start the  conversion on  all directories  inside the area-file
  4551.          that you  assign. This  is only  useful when  you make usage of
  4552.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4553.          option.  The  QBBSPaths  option  is  meant for generic QuickBBS
  4554.          <tm> systems.
  4555.  
  4556.          [areafile]    This parameter must contain the drive,  directory
  4557.                        and  filename  of  the  QBBS  areafile.  MTA will
  4558.                        validate if it is  present. The file must  follow
  4559.                        the  standard  (transparent)  FLSEARCH.BBS   file
  4560.                        format for QuickBBS <tm> versions 2.74  and  less
  4561.                        supply {ver}  with  a value of 'OLD' or must be a
  4562.                        file of  the  FILECFG.DAT  type for versions 2.75
  4563.                        and higher;
  4564.  
  4565.          {ver}         Must be either  OLD  or NEW (OLD is the default).
  4566.                        OLD must  be  supplied   if  [areafile] points to a
  4567.                        FLSEARCH.CTL alike  file. NEW must be supplied if
  4568.                        [areafile] is  a  FILECFG.DAT  alike file that is
  4569.                        in use by QuickBBS <tm> from version 2.75 and up.
  4570.  
  4571.          MTA will work on ALL areas  that are supplied in this file.  If
  4572.          you  want  some  extra  areas,  then add some extra DefaultPath
  4573.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4574.          QBBSPaths and the RAPaths options are merged together when they
  4575.          are supplied. Also the directories from MAXPaths are included !
  4576.          IF MTA can  detect  a  CDROM  area  (FILES.BBS and files are in
  4577.          different directries), it will ignore this directory unless you
  4578.          add it with a DefaultPath option !
  4579.  
  4580.  Relate: DefaultPath, RAPaths, MAXPaths
  4581.  Dest. : All
  4582.  
  4583.  
  4584.  ┌─────────────────────────────────────────────────────────────────────┐
  4585.  │ MAXPaths [areafile]                                                 │
  4586.  └─────────────────────────────────────────────────────────────────────┘
  4587.  Usage : If you change your file  areas once in a while, you can  decide
  4588.          to  use  another  source  for   MTA  than  the  usage  of   the
  4589.          DefaultPath option. If you  use the MAXPaths option,   MTA will
  4590.          start the  conversion on  all directories  inside the area-file
  4591.          that you  assign. This  is only  useful when  you make usage of
  4592.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4593.          option.  The  MAXPaths  option  is   meant for generic  MAXIMUS
  4594.          <tm> systems (based on MAXIMUS 2.xx and higher versions).
  4595.  
  4596.          [areafile]    This parameter must contain the drive,  directory
  4597.                        and filename of the  MAXIMUS  areafile.  MTA will
  4598.                        validate if it is  present. The file must  follow
  4599.                        the  standard  AREAS.DAT file for MAXIMUS 2.xx or
  4600.                        higher.
  4601.  
  4602.          MTA will work on ALL areas  that are supplied in this file.  If
  4603.          you  want  some  extra  areas,  then add some extra DefaultPath
  4604.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4605.          QBBSPaths and the RAPaths options are merged together when they
  4606.          are supplied.
  4607.          IF MTA can  detect  a  CDROM  area  (FILES.BBS and files are in
  4608.          different directries), it will ignore this directory unless you
  4609.          add it with a DefaultPath option !
  4610.  
  4611.  Relate: DefaultPath, RAPaths, QBBSPaths
  4612.  Dest. : All
  4613.  
  4614.  
  4615.  ┌─────────────────────────────────────────────────────────────────────┐
  4616.  │ RAPaths [areafile] {RAver}                                          │
  4617.  └─────────────────────────────────────────────────────────────────────┘
  4618.  Usage : If you change your file  areas once in a while, you can  decide
  4619.          to  use  another  source  for   MTA  than  the  usage  of   the
  4620.          DefaultPath option.  If you  use the  RAPaths option,  MTA will
  4621.          start the  conversion on  all directories  inside the area-file
  4622.          that you  assign. This  is only  useful when  you make usage of
  4623.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  4624.          option.  The  RAPaths  option  is  meant for Remote Access <tm>
  4625.          systems.
  4626.  
  4627.          [areafile]    This parameter must contain the drive,  directory
  4628.                        and  filename  of  the  RA  areafile.  MTA   will
  4629.                        validate if it is  present. The file must  follow
  4630.                        the standard (transparent) FILES.RA file format;
  4631.  
  4632.          {RAVer}       There are several formats of the FILES.RA   file,
  4633.                        depending on  the version  of Remote  Access <tm>
  4634.                        you use. If you  do not supply this  parameter, a
  4635.                        RA 1.1x is assumed.  If you run an  older version
  4636.                        of  RA,  you  must  supply  a '0'  for   versions
  4637.                        0.0x or a '1' for versions 1.0x. If  you  use the
  4638.                        special FILES.nnn (where nnn equals the FILEAREA)
  4639.                        files for CDRom  files  (only version 1.1x),  you
  4640.                        must supply a directory as  second  parameter and
  4641.                        not a '0' or '1'. In this case RA version 1.1x is
  4642.                        assumed and the directory you  supplied  will  be
  4643.                        used by MTA to  detect  file-area's that are on a
  4644.                        offline device. MTA will NOT work on these files.
  4645.  
  4646.  
  4647.          Examples: RA 0.0x    RAFILES C:\FILES.RA 0
  4648.                    RA 1.0x    RAFILES C:\FILES.RA 1
  4649.                    RA 1.1x    RAFILES C:\FILES.RA D:\FILES\
  4650.  
  4651.          MTA will work on ALL areas  that are supplied in this file.  If
  4652.          you  want  some  extra  areas,  then add some extra DefaultPath
  4653.          options to MTA.CTL. All  directories from the DefaultPath,  the
  4654.          QBBSPaths,MAXPaths and RAPaths options are merged together when
  4655.          they are supplied. IF MTA can detect the presence of a CDRom
  4656.          file-area (the FILES.BBS is in another location than the files)
  4657.          it will IGNORE such directory. If it must be included, you need
  4658.          to add a extra DefaultPath option !
  4659.  
  4660.  
  4661.  
  4662.  Relate: DefaultPath, QBBSPaths, MAXPaths
  4663.  Dest. : All
  4664.  
  4665.  
  4666.  ┌─────────────────────────────────────────────────────────────────────┐
  4667.  │ ExcludeDirectory [dir]                                              │
  4668.  └─────────────────────────────────────────────────────────────────────┘
  4669.  Usage : This option is mainly used when you want to exclude one or more
  4670.          (up to 255) directories from the directories that are collected
  4671.          by RAPaths, QBBSPaths and/or MAXPaths. If one or more of the
  4672.          directories inside in the BBS contain abnormal archives (other
  4673.          platforms), you can exclude such directory to overcome the
  4674.          problem that otherwise would occur when MTA starts converting
  4675.          these archives !
  4676.  
  4677.          [dir]         This value must point to a valid  drive/directory
  4678.                        which will be excluded from RAPaths, QBBSPaths or
  4679.                        MAXPaths (even from DefaultPath, but this has no
  4680.                        useful meaning).
  4681.  
  4682.  Relate: DefaultPath, QBBSPaths, MAXPaths, RAPaths
  4683.  Dest. : All
  4684.  
  4685.  ┌─────────────────────────────────────────────────────────────────────┐
  4686.  │ CarryComment [type] {comment}                                       │
  4687.  └─────────────────────────────────────────────────────────────────────┘
  4688.  Usage : This option is  another way of putting (useful)  comment inside
  4689.          the  target  archives.  There  are  various  in  which way this
  4690.          option can work, but only one is allowed. You can overrule  the
  4691.          type of work with the /CARCOM command-line option though.
  4692.  
  4693.          With CarryComment you order MTA to carry over any comment  from
  4694.          the source  archive (PAK/ZIP/ARJ/ZOO)  into the  target archive
  4695.          (same types). The carry can be done in three different ways.
  4696.  
  4697.          [type]        This  parameter can be set to 1, 2 or 3.  The way
  4698.                        CarryComment will work depends on the number  you
  4699.                        set  over  here.  The  values  have the following
  4700.                        meaning:
  4701.  
  4702.                        1 : MTA  will carry over  the comment (up  to 256
  4703.                            bytes) from the source file, if a comment  is
  4704.                            available;
  4705.  
  4706.                        2 : MTA will first look into the source file  and
  4707.                            will remember up to 256 bytes of the  comment
  4708.                            (if any).   After conversion,  MTA will  look
  4709.                            into the  file you  supplied in  the FilesBBS
  4710.                            option (if  you did  supply this  option). If
  4711.                            the file  has a  record inside  the FILES.BBS
  4712.                            (or alike  file), THIS  comment is  taken and
  4713.                            not the comment  in the source  file.  If  no
  4714.                            comment  is  available,  MTA  will  use   the
  4715.                            comment from the source file (if any);
  4716.  
  4717.                        3 : MTA will  always look into the  FILES.BBS (or
  4718.                            alike) file. This is only valid when you  use
  4719.                            the  FilesBBS   option.  If   a  record    is
  4720.                            available,  the  comment  is  carried over to
  4721.                            the target  file. If  no record  is available
  4722.                            the target will NOT have any comment;
  4723.  
  4724.          {comment}     When you supply this  parameter (spaces must   be
  4725.                        replaced  with  underscore  characters), MTA will
  4726.                        put this  comment IN  FRONT of  the comment  that
  4727.                        came from the carry itself. There will be a  CRLF
  4728.                        between this comment and the following  (carried)
  4729.                        comment.
  4730.  
  4731.          You can make a combination  of the AutoComment and the  current
  4732.          option (CarryComment). In  this case, MTA  will add a  combined
  4733.          into  the  target-file.  In  the  combination, the comment from
  4734.          AutoComment file  comes first  and the  comment constructed  by
  4735.          the  CarryComment  statement  comes  directly  (WITHOUT A CRLF)
  4736.          after this comment. Please keep  in mind that you separate  the
  4737.          two comments yourself (if needed) by adding a CRLF in the  file
  4738.          assigned by AutoComment.
  4739.  
  4740.          Please  also  read  the  info  on  the  FilesBBS option and the
  4741.          AddFilesBBS option.
  4742.  
  4743.  Relate: FilesBBS, AddFilesBBS
  4744.  Source: ZIP/PAK/ZOO/ARJ
  4745.  Dest. : ZIP/PAK/ZOO/ARJ
  4746.  
  4747.  
  4748.  ┌─────────────────────────────────────────────────────────────────────┐
  4749.  │ FILEIDDIZ {name1} {name2} {name3} {name4} {name5}                   │
  4750.  └─────────────────────────────────────────────────────────────────────┘
  4751.  Usage : For  some  BBS   programs,  the file FILE_ID.DIZ has a  special
  4752.          meaning.  It  contains  a  description  of the programs (files)
  4753.          that are included inside the  archive. MTA can do a  few things
  4754.          with  this  comment.  If  you  use this option (FILEIDDIZ), you
  4755.          instruct MTA to  store the text  from FILE_ID.DIZ into  memory.
  4756.          This  is  done, only  when  the  archive  actually  contains  a
  4757.          FILE_ID.DIZ file (or name-like, see parameters).
  4758.  
  4759.          You can also instruct MTA to search for other files that have
  4760.          the same usage as FILE_ID.DIZ. In some distribution nets, the
  4761.          author can create two files, one containing 'high' characters
  4762.          and one containing only characters in the range X'00'-X'127'.
  4763.          Other types of files will also be used for sure, so MTA is very
  4764.          'dynamic' in the usage of this option.
  4765.  
  4766.          {name1}       Normally MTA will  look for files with the   name
  4767.            //          FILE_ID.DIZ. If this is not the correct  standard
  4768.          {name5}       on  your  system,  MTA   can   look for (an)other
  4769.                        file(s) with such usage but  with different names.
  4770.                        MTA will  use  the  priority in the way you order
  4771.                        the different names. If you use A B C D and E for
  4772.                        {name1} to {name5} and the  archive contains both
  4773.                        B and D, MTA  will  use B and will leave D alone.
  4774.                        If you use A D C B and E, MTA will use the D-file
  4775.                        because it comes first in the list. There  can be
  4776.                        a maximum of 5 different names !
  4777.  
  4778.          Previous versions of MTA were not so relaxed when the format of
  4779.          the FILE_ID.DIZ was  tested. There  is  no  actual standard for
  4780.          this file, though the original distribution-net used files with
  4781.          8 lines, each containing  43  bytes of text (FILES.BBS format).
  4782.          MTA would give a warning when more (or less) lines were present
  4783.          and the lines exceeded the 43  byte bounds. Because of the more
  4784.          dynamic usage (not only  FILE_ID.DIZ can be used), MTA will now
  4785.          store up to 20 lines  of  (up to) 128 bytes of text without any
  4786.          warning.
  4787.  
  4788.          This option  (on its  own) will  not do  more than  reading the
  4789.          file FILE_ID.DIZ  (or the names you  supplied) and  storing the
  4790.          information  in  memory.  What  is  going  to  happen with this
  4791.          informations is  depending on  the FilesBBS/AddFILESBBS  option
  4792.          and/or the StoreComment and ReplaceComment option).
  4793.  
  4794.  
  4795.  Relate: FilesBBS/AddFilesBBS, StoreComment, ReplaceComment
  4796.  Source: All
  4797.  Dest. : All
  4798.  
  4799.  
  4800. │┌─────────────────────────────────────────────────────────────────────┐
  4801. ││ LeadingSpace TRIM                                                   │
  4802. ││ LeadingSpace CHAR [char]                                            │
  4803. │└─────────────────────────────────────────────────────────────────────┘
  4804. │Usage : This  is  a very  special option that can be used when you work
  4805. │        with special door-programs that list your FILES.BBS-alike files
  4806. │        in a non-conventional way.
  4807. │
  4808. │        When MTA  obtains  information  from the FILE_ID.DIZ (or alike)
  4809. │        files  and  this  comments  contains spaces at the beginning of
  4810. │        the second (or higher) line, like:
  4811. │
  4812. │        This file description has a special format because
  4813. │            - It contains spaces at the start of this line
  4814. │            - And again
  4815. │            - And again
  4816. │
  4817. │        it will keep this spaces (by default), resulting in entries  in
  4818. │        the FILES.BBS-alike file, that look like this:
  4819. │
  4820. │        ffffffff.eee This file description has a special format because
  4821. │         +    - It contains spaces at the start of this line
  4822. │         +    - And again
  4823. │         +    - And again
  4824. │
  4825. │        Some  door-programs  that list  FILES.BBS-alike files with this
  4826. │        format, will  display  these lines with a bad adjustment on the
  4827. │        screen. To overcome  this  problem, you can use LEADINGSPACE to
  4828. │        convert the descriptions.
  4829. │
  4830. │        TRIM  :  When TRIM  is used, MTA  will strip all leading spaces
  4831. │                 from the comment and will add the '+' before the first
  4832. │                 non-space character;
  4833. │
  4834. │        CHAR  :  When CHAR is used, MTA will replace all leading spaces
  4835. │                 with the  character  [char]. [char] can  be coded as a
  4836. │                 single  character (like 'Leadingspace #', resulting in
  4837. │                 the replacement  of each leading space into '#') or as
  4838. │                 a 3-digit  number (like 'Leadingspace 225',  resulting
  4839. │                 in the  replacement  of  each leading  space into 'ß').
  4840. │                 The number must be decimal !
  4841. │
  4842. │Relate: FILEIDDIZ, ADDFILESBBS
  4843. │Dest. : All
  4844.  
  4845.  
  4846.  ┌─────────────────────────────────────────────────────────────────────┐
  4847.  │ ReplaceComment                                                      │
  4848.  └─────────────────────────────────────────────────────────────────────┘
  4849.  Usage : When you use the FILEIDDIZ parameter, MTA can add new comments
  4850.          to FILES.BBS that come from this file (see FILEIDDIZ option).
  4851.          Normally, MTA will not REPLACE a comment in FILES.BBS with the
  4852.          comment taken from this file. This could cause much harm to all
  4853.          your FILES.BBS files when you (re)convert a complete area of
  4854.          files. All you modified comments would be removed when a file
  4855.          contains a FILE_ID.DIZ-alike file.
  4856.  
  4857.          If you want to replace existing comments in FILES.BBS with the
  4858.          comment that comes from a FILE_ID.DIZ-alike file that is  read
  4859.          when the file  in  question  is converted, you can supply this
  4860.          option but be  careful. For  starters,  MTA remove the comment
  4861.          somewhere in the  FILES.BBS  and  will  add the new comment to
  4862.          the end of the  FILES.BBS. Also,  carefully  created  comments
  4863.          with nice  bells  and  whistles are replaced by something that
  4864.          indeed covers the file-description but is always very simple !
  4865.  
  4866.  Relate: FilesBBS/AddFilesBBS, FILEIDDiz
  4867.  Source: All
  4868.  Dest. : All
  4869.  
  4870.  
  4871. │┌─────────────────────────────────────────────────────────────────────┐
  4872. ││ DefFilesBBSDesc [mask] [desc]                                       │
  4873. │└─────────────────────────────────────────────────────────────────────┘
  4874. │Usage : When MTA has to add the converted file to the FILES.BBS (alike)
  4875. │        file and there  is  NO  comment taken from ANY location (any of
  4876. │        the FILE_ID.DIZ-alike files and/or previous FILES.BBS entries),
  4877. │        MTA will  (by default)  add  'No description available' as  the
  4878. │        comment  inside the  FILES.BBS-alike file. Previous versions of
  4879. │        MTA would  even only  add the  filename (and no comment) to the
  4880. │        FILES.BBS-alike file when the archive was NEW.
  4881. │
  4882. │        MTA  will  now,  by default, put  'No description available' in
  4883. │        the  FILES.BBS-alike file. This will be the case if NO previous
  4884. │        description  is  available (FILE_ID.DIZ, FILES.BBS)  and/or the
  4885. │        archive is NEW.
  4886. │
  4887. │        BEFORE MTA  will  add 'No description available', MTA will scan
  4888. │        all available DefFILESBBSDesc options in MTA.CTL. These options
  4889. │        (up to 255 are allowed) have two parameters:
  4890. │
  4891. │        [mask]        This must  be a valid DOS, 4Dos <tm> or DISP <tm>
  4892. │                      filename  mask  (wildcards allowed). There are no
  4893. │                      directories allowed;
  4894. │
  4895. │        [desc]        This must  be the description that belongs to the
  4896. │                      previous  [mask]. It  can  be  up to 47 byte long
  4897. │                      and spaces are allowed.
  4898. │
  4899. │        If MTA can  match  the filename with a mask, the comment of the
  4900. │        FIRST match  is  carried  over  into  the FILES.BBS-alike file.
  4901. │        You can also use  this option to change the default comment for
  4902. │        ALL files.
  4903. │
  4904. │        An example:
  4905. │
  4906. │        DefFilesBBSDesc NODELIST.*   The new nodelist file
  4907. │        DefFilesBBSDesc NODEDIFF.*   The new nodelist difference file
  4908. │        DefFilesBBSDesc NODE*.*      Something to do with the nodelist
  4909. │        DefFilesBBSDesc *.LU         ARRRG, who uses LU these days ?
  4910. │        DefFilesBBSDesc *.*          No description found, sorry !
  4911. │
  4912. │        The following files will give the following results:
  4913. │
  4914. │        NODELIST.A26    Decription : The new nodelist file
  4915. │        NODESHIT.A88                 Something to do with the nodelist
  4916. │        NADASHIT.Z12                 No description found, sorry !
  4917. │        BAR.LU                       ARRRG, who uses LU these days ?
  4918. │        FOOBAR.ZOO                   No description found, sorry !
  4919. │
  4920. │Relate: FilesBBS/AddFilesBBS, FILEIDDiz, CarryComment
  4921. │Source: All
  4922.  
  4923.  
  4924.  ┌─────────────────────────────────────────────────────────────────────┐
  4925.  │ FilesBBS {location}                                                 │
  4926.  └─────────────────────────────────────────────────────────────────────┘
  4927.  Usage : If you convert files, the name will change in most cases  (from
  4928.          the source system, fi.  A.ZIP, to the destination,  fi. A.LZH).
  4929.          This change will  cause any entry  in the FILES.BBS  alike file
  4930.          to be  invalid. MTA  can help  out in  this case.  When you add
  4931.          this  option,  the  entries  in  the  FILES.BBS  alike file (if
  4932.          available) will also change !
  4933.  
  4934.          There are several  formats of this  option. If coded  without a
  4935.          parameter, MTA will  assume FILES.BBS as  the filename and  the
  4936.          directory where the conversion  takes place as the  location of
  4937.          the file.
  4938.  
  4939.          {location}    This parameter is optional an can either contain:
  4940.  
  4941.                        - A filename. In  this case MTA will  assume this
  4942.                          filename  as  the  name  of the FILES.BBS alike
  4943.                          file  and  the  directory  where the conversion
  4944.                          takes place as the location;
  4945.  
  4946.                        - A  full path,  containing drive,  directory and
  4947.                          filename. In  this case,  MTA will  assume that
  4948.                          you only  have ONE  FILES.BBS alike  file (this
  4949.                          is the case  for RBBS-alike systems).  The name
  4950.                          and location are assigned with this parameter.
  4951.  
  4952.          When you don't use  the FilesBBSFormat option (see  later), MTA
  4953.          will search  for filenames  in position  1 of  each record  and
  4954.          with the format FILENAME.EXT (upper- and lower case).   Changes
  4955.          are  made  after  every  conversion.   If  MTA  aborts  on   an
  4956.          operation,  all  PREVIOUS  archives  that  are  converted   ARE
  4957.          already changed in the FILES.BBS alike file(s).
  4958.  
  4959.          If you run  the ExitAfterCompression to  create SFX files  from
  4960.          the target  archives, the  change in  the FILES.BBS  alike file
  4961.          will  be   incorrect  !   You  must   use  one   of  the    MTA
  4962.          CompressionType values that instruct MTA to create the SFX.  In
  4963.          this case the change will be done correctly !
  4964.  
  4965.          It is also possible to change any sizes in the FILES.BBS  alike
  4966.          file(s). Some  of these  files contain  the actual  size of the
  4967.          file (RBBS master  directory). MTA will  change the size  also,
  4968.          if the correct size was already present in the FILES.BBS  alike
  4969.          file.
  4970.  
  4971.          If comments in the FILES.BBS  alike file start with a  download
  4972.          counter (e.g. FILENAME.EXT [01]  Downloaded once), and you  use
  4973.          the CarryComment  option (types  2 or  3), MTA  will strip  the
  4974.          download-counter  (only  when  the  format  is [nnnn]) from the
  4975.          description  that  will  be  added  to  the archive (not in the
  4976.          FILES.BBS alike file).
  4977.  
  4978.          This option  can also  be used  in a  NON-BBS environment where
  4979.          4Dos is installed and used. You should set the various  options
  4980.          as follows:
  4981.  
  4982.          - Set the FilesBBS option       to 'FilesBBS DESCRIPT.ION';
  4983.          - Set the FilesBBSFormat option to 'FilesBBSFormat 1 1 I2';
  4984.          - Set the AddFilesBBS option;
  4985.          - Set the CarryComment option to 2 (without extra parameters);
  4986.  
  4987.          In this case the comment will  be carried over out of the  4Dos
  4988.          DESCRIPT.ION file (this  is a hidden  file that 4DOS  maintains
  4989.          when you  use the  DESCRIBE command),  the change  of extension
  4990.          (if any) will be performed in the same file and if there is  no
  4991.          comment for this file in  the DESCRIPT.ION file, MTA can  carry
  4992.          over the comment from the archive (if any) into this file.
  4993.  
  4994.          When the FilesBBS option is active and MTA detects a  defective
  4995.          archive, MTA will move  this archive to the  supplied directory
  4996.          for  archives  in  error.  MTA  will also carry the description
  4997.          from the original FILES.BBS alike file over to a new  FILES.BBS
  4998.          alike file in this error directory.  The original comment  will
  4999.          ALSO  stay  in  the  original  FILES.BBS  alike  file. When the
  5000.          FILES.BBS alike  file is  on a  fixed location,  this option is
  5001.          not triggered.
  5002.  
  5003.  Relate: FilesBBSFormat
  5004.  Dest. : All
  5005.  
  5006.  
  5007.  ┌─────────────────────────────────────────────────────────────────────┐
  5008.  │ AddFilesBBS                                                         │
  5009.  └─────────────────────────────────────────────────────────────────────┘
  5010.  Usage : If you receive new  files without any entries in the  FILES.BBS
  5011.          alike file,  MTA can  add them  for you.  If the source archive
  5012.          also contains a  description (comment), this  is also added  to
  5013.          that file. The AddFilesBBS  option will ONLY function  when you
  5014.          have  set  the  FilesBBS  option.  The description will only be
  5015.          added (if present) when the  CarryComment option is set with  a
  5016.          value of 1 or 2. The format of the added record is the same  as
  5017.          set in the FilesBBSFormat option.
  5018.  
  5019.          If you have set the FILEIDDIZ option AND there is such a file
  5020.          inside the archive, MTA will use THIS comment (it has a higher
  5021.          priority than CarryComment) for the new entry in the FILES.BBS
  5022.          alike file. If there already IS a comment in the FILES.BBS
  5023.          alike file (for this file), MTA will NOT overwrite that comment
  5024.          with the new comment.
  5025.  
  5026. │        If MTA  is unable to obtain comments from the FILEIDDIZ option,
  5027. │        it will also search in any DESCRIPT.ION file (4Dos <tm> comment
  5028. │        file) or in  any ?????????.I?? (FileDoor <tm> information file)
  5029. │        file before searching in the DefFilesBBSDesc options !
  5030.  
  5031.  Relate: FilesBBSFormat, FilesBBS, CarryComment, FileIDDiz,
  5032.          DefFilesBBSDesc
  5033.  Dest. : All
  5034.  
  5035.  
  5036.  ┌─────────────────────────────────────────────────────────────────────┐
  5037.  │ FilesBBSFormat [name] [extension] [comment]                         │
  5038.  └─────────────────────────────────────────────────────────────────────┘
  5039.  Usage : This option will instruct MTA about the internal format of  the
  5040.          FILES.BBS alike  file.   Under default  conditions, MTA expects
  5041.          the  filename  to  start  on  position  1  of each line, with a
  5042.          filename format  for name.ext  (with a  point between  the name
  5043.          and the  extension) and  the comment  to start  on position 14.
  5044.          When your FILES.BBS alike file  (if you use any) is  different,
  5045.          you must use this option to set the new format.
  5046.  
  5047.          [name]        This parameter must be set to the position  where
  5048.                        the filename will start;
  5049.  
  5050.          [extension]   This parameter must be set to the position  where
  5051.                        the  extension  will  start.  If filename and the
  5052.                        extension  are  combined  together  with a point,
  5053.                        [name] and [extension] must be the same value;
  5054.  
  5055.          [comment]     This parameter must be the starting point of  the
  5056.                        comment.  If  the  FILES.BBS  alike file does not
  5057.                        contain a comment,  you must set  it to 255.   If
  5058.                        the comment 'floats'  somewhere in the  file, the
  5059.                        starting position  is different  every time,  you
  5060.                        can use another format.  In this case you  supply
  5061.                        the ITEM NUMBER  (and not the  starting position)
  5062.                        with the value 'I'. For example:
  5063.  
  5064.                        My.ZIP 1234 The comment
  5065.                        Our.ZIP 233222 The comment
  5066.  
  5067.                        In  this  case,  the  comment  is floating but is
  5068.                        always the 4th item.  In this case you  supply I4
  5069.                        for this parameter.
  5070.  
  5071.          The FilesBBSFormat option only has a meaning when the  FilesBBS
  5072.          option is also set.
  5073.  
  5074.  Relate: FilesBBS
  5075.  Dest. : All
  5076.  
  5077.  
  5078. │┌─────────────────────────────────────────────────────────────────────┐
  5079. ││ FilesCounter [location] {startchar} {endchar}                       │
  5080. │└─────────────────────────────────────────────────────────────────────┘
  5081. │Usage : This  option  can  be used to instruct MTA how to recognize and
  5082. │        use files-counters  in  the  FILES.BBS-alike file. MTA will use
  5083. │        the information  to  strip files-counter from descriptions that
  5084. │        are added as  comment  to the archive (CARRYCOMMENT option) and
  5085. │        to add  files-counters  when  the  filenames are changed in the
  5086. │        FILES.BBS-alike  files or  files are added to this file (if the
  5087. │        ADDFILESBBS option is set).
  5088. │
  5089. │        [location]    This is the  location of the files-counter in the
  5090. │                      FILES.BBS-alike file. Valid values are:
  5091. │
  5092. │                      NONE  : There  are  NO  files-counters set in the
  5093. │                              FILES.BBS-alike  files (you don't use any
  5094. │                              counters);
  5095. │
  5096. │                      START : The  files-counters  are  placed  at  the
  5097. │                              start of the comment;
  5098. │
  5099. │                      END   : The files-counters  are placed at the end
  5100. │                              of the comment;
  5101. │
  5102. │        {startchar}   This  parameter  can  be  used to  tell MTA which
  5103. │                      character  is  used as the starting character for
  5104. │                      the files-counter (like '[', '{', '(' and so on).
  5105. │                      By default MTA  assumes  the '[' character as the
  5106. │                      start-character of the files-counter;
  5107. │
  5108. │        {endchar}     This  parameter  can  be  used  to tell MTA which
  5109. │                      character is used as the ending character for the
  5110. │                      files-counter (like ']', '}', ')' and  so on). By
  5111. │                      default MTA assumes the ']' character as the end-
  5112. │                      character of the files-counter;
  5113. │
  5114. │
  5115. │        When no FILESCOUNTER option is supplied, MTA will assume:
  5116. │
  5117. │        FilesCounter START [ ]
  5118. │
  5119. │        E.g. counters  at  the  start of the comment, starting with '['
  5120. │        and ending with ']'. FILES.BBS-alike entries will look like:
  5121. │
  5122. │        nnnnnnnn.eee [##] ccccccccccccccccccccccccccccccccccccccccc
  5123. │
  5124. │        When you do not use any counters in your FILES.BBS-alike files,
  5125. │        you have to set:
  5126. │
  5127. │        FilesCounter NONE
  5128. │
  5129. │Relate: FilesBBS, AddFilesBBS, CarryComment
  5130. │Dest. : All
  5131.  
  5132.  
  5133.  ┌─────────────────────────────────────────────────────────────────────┐
  5134.  │ TICKFiles [mask]                                                    │
  5135.  │ FESFiles  [mask]                                                    │
  5136.  └─────────────────────────────────────────────────────────────────────┘
  5137.  Usage  :  Until  now,  all  previous  BBS-options had to do with normal
  5138.          FILES.BBS alike type of  files. The following options  do some-
  5139.          thing  with  other  types  of  files.   These  options makes it
  5140.          possible to pick  up the description  of a certain  file from a
  5141.          TICK or  FES file.  When you  get your  files into  the inbound
  5142.          directory and the *.TIC/FES files along with them, you can  now
  5143.          convert them (and  optionally move them)  to any other  system,
  5144.          while MTA will try to extract the comment of the file from  the
  5145.          associated TICK/FES-file. You can  do two types of  things with
  5146.          these  comments.  You  can  add  them  to  the  FILES.BBS   (if
  5147.          AddFILESBBS is set to on) AND you can store them in the  header
  5148.          of the archive (comment) when CarryComment is set to on.
  5149.  
  5150.          If CarryComment is on (independent  of the type 1,2 or  3), MTA
  5151.          will  search  for  the  comment  in the old archive-header, the
  5152.          FILES.BBS or  both. If  TICKFiles is  set   AND MTA  can find a
  5153.          description in any of the TICK-files, this comment will  always
  5154.          overrule the comment from the FILES.BBS or the old header.  The
  5155.          same goes for the FESFiles option.
  5156.  
  5157.          [mask]        This parameter must point to a drive,   directory
  5158.                        and  filemask.   Most  obvious   is  to   include
  5159.                        *.TIC as   the  filemask   (and  in   some  cases
  5160.                        *.BAD can also be handy).
  5161.  
  5162.          You  can  use  multiple  TICKFiles  options to assign different
  5163.          TICK files (*.TIC and *.BAD) and in different directories.   Up
  5164.          to  10  are  allowed.  Also  10  FESFiles  options  are allowed
  5165.          (*.FES, *.BAD).
  5166.  
  5167.          The  TICK/FES-files  are  ALL  searched  (for  every  converted
  5168.          archive) until either:
  5169.  
  5170.          - a description is found;
  5171.  
  5172.          - all files are processed and no description was found;
  5173.  
  5174.          MTA will  search for  either FILE:  or FILE  and DESC: and DESC
  5175.          inside the TICK-files. This is  pointed out in FSC-0028 !   The
  5176.          FES files follow the authors description !
  5177.  
  5178.  Relate: FilesBBS, AddFilesBBS, CarryComment
  5179.  Dest. : All
  5180.  
  5181.  
  5182.  ┌─────────────────────────────────────────────────────────────────────┐
  5183.  │ UpdateUntypedFiles [mask]                                           │
  5184.  └─────────────────────────────────────────────────────────────────────┘
  5185.  Usage : This is  a special, independent, option  to update any type  of
  5186.          file with the new (converted) name of the archive. Let us  take
  5187.          an example:
  5188.  
  5189.          -) Some  products keeps  a small  database with  names of files
  5190.             (also your archives) inside.   RFW is such an example.   Now
  5191.             you  convert  some  archive  and  the information inside the
  5192.             database has  become invalid  !   UpdateUntypedFiles is  the
  5193.             answer to your problem.
  5194.  
  5195.          UpdateUntypedFiles will update ANY type of file (even a program
  5196.          or binary file) with the new name of the archive IF:
  5197.  
  5198.          - You don't use the /D option;
  5199.  
  5200.          - The name  of the target  has the same  length as the  name of
  5201.            the source. A  conversion from something.ZIP  to Something.MD
  5202.            will not be performed;
  5203.  
  5204.          - The name location is  within the 64K (65535) bytes  bounds of
  5205.            the file;  Longer files  will NOT  be truncated  but only the
  5206.            first 64K of bytes are scanned and (optionally) changed;
  5207.  
  5208.          [mask]        This parameter must point to a drive,   directory
  5209.                        and filemask.
  5210.  
  5211.          You can add up to  10 UpdateUntypedFiles options into the  file
  5212.          MTA.CTL. But be smart and think before you do. MTA will  search
  5213.          ALL files and though  this is fast I/O,  it can take some  time
  5214.          if you include numerous files !
  5215.  
  5216.          UpdateUntypedFiles can be used  as a replacement to  the update
  5217.          of the  FILES.BBS alike  file(s) when  these files  are smaller
  5218.          than 64K.  In that  case, this  option will  give you a 50-200%
  5219.          gain in speed over the FilesBBS option !!.
  5220.  
  5221.  Relate: UpdateTICKFiles, UpdateFESFiles
  5222.  Dest. : All
  5223.  
  5224.  
  5225. │┌─────────────────────────────────────────────────────────────────────┐
  5226. ││ UpdateUntypedFull                                                   │
  5227. │└─────────────────────────────────────────────────────────────────────┘
  5228. │Usage : This option can be used in combination with the previous option
  5229. │        (UPDATEUNTYPEDFILES). If  this  option  is  set, MTA  will only
  5230. │        change the filename  in  the  'untyped file'  when both the old
  5231. │        filename AND the name of the directory both match the converted
  5232. │        file.
  5233. │
  5234. │        Without this option, MTA will only change the file when the old
  5235. │        old filename matches but MTA won't look at the directoryname.
  5236. │
  5237. │        You should  set  this option when you use UPDATEUNTYPEDFILES to
  5238. │        update *.MSG files with attached files (TICK/FES support) !
  5239. │
  5240. │Relate: UpdateUntypedFiles
  5241. │Dest. : All
  5242.  
  5243.  
  5244.  ┌─────────────────────────────────────────────────────────────────────┐
  5245.  │ UpdateTICKFiles [mask]                                              │
  5246.  │ UpdateFESFiles  [mask]                                              │
  5247.  └─────────────────────────────────────────────────────────────────────┘
  5248.  Usage : The syntax  is the  same as  with UpdateUntypedfiles.  See  the
  5249.          chapter  about  TICK  files,  later  in this documentation. The
  5250.          material is to complex to put over here.
  5251.  
  5252. │Relate: UpdateUntypedFiles, UpdateMSGFiles
  5253.  Dest. : All
  5254.  
  5255.  
  5256. │┌─────────────────────────────────────────────────────────────────────┐
  5257. ││ UpdateMSGFiles [dir]                                                │
  5258. │└─────────────────────────────────────────────────────────────────────┘
  5259. │Usage : The UPDATEMSGFILES option has a different format than the three
  5260. │        previous options. There can be ut to 255 of these options with
  5261. │        the following parameter:
  5262. │
  5263. │        [dir]         This parameter must point to a ddirectory where
  5264. │                      your *.MSG files are. Do not code the file-mask,
  5265. │                      but ONLY the directory.
  5266. │
  5267. │        See the chapter on TICK files for a description of this option.
  5268. │
  5269. │Relate: UpdateTICKFiles, UpdateFESFiles
  5270. │Dest. : All
  5271. │
  5272. │
  5273. │┌─────────────────────────────────────────────────────────────────────┐
  5274. ││ UpdateMSGFull                                                       │
  5275. │└─────────────────────────────────────────────────────────────────────┘
  5276. │Usage : Same as the UPDATEUNTYPEDFULL  option  but now in relation with
  5277. │        the UPDATEMSGFILES option.
  5278. │
  5279. │        You  should  set  this  option  when  you use UPDATEMSGFILES to
  5280. │        update *.MSG files with attached files (TICK/FES support) !
  5281. │
  5282. │Relate: UpdateMSGFiles
  5283. │Dest. : All
  5284.  
  5285.  
  5286.  ┌─────────────────────────────────────────────────────────────────────┐
  5287.  │ COMPort [port]                                                      │
  5288.  └─────────────────────────────────────────────────────────────────────┘
  5289.  Usage : MTA has internal modem support. This is needed in case you  run
  5290.          MTA as an exit of the  BBS (e.g. a protocol driver like  DISP's
  5291.          FileDoor). When you  use modem support,  MTA will echo  some of
  5292.          the progress to the COM-port and the user can follow a part  of
  5293.          the  conversion.  All  modem  related  options  will do NOTHING
  5294.          unless the Remote option or the /REMOTE command-line  parameter
  5295.          is used.
  5296.  
  5297.          [port]        This parameter must  point to the COM-port  that
  5298.                        MTA will use. If set to 0, no remote tracking  is
  5299.                        done.
  5300.  
  5301.  Relate: BaudRate, Remote, FossilPort /REMOTE
  5302.  Dest. : All
  5303.  
  5304.  
  5305.  ┌─────────────────────────────────────────────────────────────────────┐
  5306.  │ FOSSILPort [port]                                                   │
  5307.  └─────────────────────────────────────────────────────────────────────┘
  5308.  Usage : This  option  can   be  used  as a replacement for  the COMPort
  5309.          option. The major difference is  that [port] will now point  to
  5310.          the FOSSIL port number (usually 1 less than the COM-port).
  5311.  
  5312.  Relate: BaudRate, Remote, COMPort /REMOTE
  5313.  Dest. : All
  5314.  
  5315.  
  5316.  ┌─────────────────────────────────────────────────────────────────────┐
  5317.  │ BAUDRate [baud]                                                     │
  5318.  └─────────────────────────────────────────────────────────────────────┘
  5319.  Usage : When  remote tracking is  used, MTA must  know the baudrate  of
  5320.          the MTA-to-Modem speed.
  5321.  
  5322.          [baud]        This parameter must be set to the connect  speed.
  5323.                        If you  use a  locked modem,  you must  set it to
  5324.                        the locked  speed and  not to  the connect speed.
  5325.                        If set to 0, remote tracking is disabled.
  5326.  
  5327.          Normally you use  the /BAUD command-line  parameter to set  the
  5328.          baud-rate because it can vary, unless a locked speed is used.
  5329.  
  5330.  Relate: COMPort or FOSSILPort, Remote, /REMOTE
  5331.  Dest. : All
  5332.  
  5333.  
  5334.  ┌─────────────────────────────────────────────────────────────────────┐
  5335.  │ StoreSize {ext}                                                     │
  5336.  └─────────────────────────────────────────────────────────────────────┘
  5337.  Usage : This option, on its   own, does nothing, but it will be  useful
  5338.          when  remote  tracking  is  active.  In  this case it will do a
  5339.          function  that  is  specific  to  FileDoor.  If  this option is
  5340.          active and  MTA is  running under  FileDoor, MTA  will create a
  5341.          special file  with a  specific format.  This file  contains the
  5342.          ACTUAL size of  the file BEFORE  the conversion. FileDoor  will
  5343.          detect this file and will credit the user for the actual  bytes
  5344.          that were uploaded and not  the newly created number of  bytes.
  5345.          For example the user uploads  A.ARC (10000 bytes) and MTA  will
  5346.          convert it to A.ZIP  (6000 bytes). Without StoreSize,  FileDoor
  5347.          will credit  the user  for 6000  bytes but  with StoreSize set,
  5348.          FileDoor will take the actual 10000 bytes as credit.
  5349.  
  5350.          {ext}  Normally, MTA will create a file with the name equal  to
  5351.                 the archive (without  extension) and the  extension XS1.
  5352.                 This extension can only be used in FileDoor  3.01+.  All
  5353.                 earlier versions (up to 3.01Γ5)  use  the  extension F$D.
  5354.                 When you run FileDoor 2.03 (up to 3.01Γ5) or a  clone of
  5355.                 FileDoor  that  uses this system, you  must change {ext}  to
  5356.                 the proper extension (F$D in case of FileDoor 2.03);
  5357.  
  5358.          Even if you don't run remote, you can still use this option. In
  5359.          this case, it is up to you (or a batch oriented program) to  do
  5360.          something with the created file(s).
  5361.  
  5362.  Relate: Remote
  5363.  Dest. : All
  5364.  
  5365.  
  5366.  ┌─────────────────────────────────────────────────────────────────────┐
  5367.  │ StoreName {nam}                                                     │
  5368.  └─────────────────────────────────────────────────────────────────────┘
  5369.  Usage : This option, on its   own, does nothing, but it will be  useful
  5370.          when  remote  tracking  is  active.  In  this case it will do a
  5371.          function  that  is  specific  to  FileDoor.  If  this option is
  5372.          active and  MTA is  running under  FileDoor, MTA  will create a
  5373.          special file  with a  specific format.  This file  contains the
  5374.          name of the archives before and after the  conversion. FileDoor
  5375.          will detect this file and will use it to see any altered  names
  5376.          AFTER the upload.
  5377.  
  5378.          {nam}  Normally, MTA will create a file with the name equal  to
  5379.                 FileDoor.XS2. This filename can only be used in FileDoor
  5380.                 versions 3.01 (3.01Γ6 up to release). Only  beta-testers
  5381.                 and users  of FileDoor <tm> clones will  have  to  alter
  5382.                 {name} to something different (FILEDOOR.F#D  for gamma's
  5383.                 up to 3.01Γ5.
  5384.  
  5385.          Even if you don't run remote, you can still use this option. In
  5386.          this case, it is up to you (or a batch oriented program) to  do
  5387.          something with the created file(s).
  5388.  
  5389.  Relate: Remote
  5390.  Dest. : All
  5391.  
  5392.  
  5393.  ┌─────────────────────────────────────────────────────────────────────┐
  5394.  │ StoreComment {ext}                                                  │
  5395.  └─────────────────────────────────────────────────────────────────────┘
  5396.  Usage : This option, on its   own, does nothing, but it will be  useful
  5397.          when  remote  tracking  is  active.  In  this case it will do a
  5398.          function  that  is  specific  to  FileDoor.  If  this option is
  5399.          active and  MTA is  running under  FileDoor, MTA  will create a
  5400.          special file  with a  specific format.  This file  contains the
  5401.          comment (from CarryComment or FileIDDIZ) for the specific  file
  5402.          that was uploaded by the user.
  5403.  
  5404.          {nam}  Normally, MTA will create a file with the name equal  to
  5405.                 FILEDOOR.XS3. This  name can  only be  used in  FileDoor
  5406.                 3.01+ (up from FileDoor 3.01Γ6). If you use  a  FileDoor
  5407.                 clone you will have to  alter {nam}  to  the  name  this
  5408.                 program uses;
  5409.  
  5410.          Even if you don't run remote, you can still use this option. In
  5411.          this case, it is up to you (or a batch oriented program) to  do
  5412.          something with the created file(s).
  5413.  
  5414.  Relate: Remote
  5415.  Dest. : All
  5416.  
  5417.  
  5418.  ┌─────────────────────────────────────────────────────────────────────┐
  5419.  │ Remote                                                              │
  5420.  └─────────────────────────────────────────────────────────────────────┘
  5421.  Usage : When set (and  when both COMPort and Baudrate  contain non-zero
  5422.          values), MTA will do remote tracking and will send messages  to
  5423.          the remote user.
  5424.  
  5425.  Relate: Baudrate,FOSSILPort,COMPort,StoreSize,StoreName,StoreComment
  5426.  Dest. : All
  5427.  
  5428.  
  5429.  ┌─────────────────────────────────────────────────────────────────────┐
  5430.  │ RemoteColor [txtlow] [txthig] [ok] [err] [act] [fil]                │
  5431.  └─────────────────────────────────────────────────────────────────────┘
  5432.  Usage : This  option can be  used to overrule  the default colors  that
  5433.          MTA uses for remote messages.
  5434.  
  5435.          [...]         There are 6 types of colors that can be   changed
  5436.                        to your own  needs. You must  supply ALL of  them
  5437.                        when  you  use  this  option.  [...] can have the
  5438.                        following values:
  5439.  
  5440.                        0  : Black            8  : DarkGray
  5441.                        1  : Blue             9  : LightBlue
  5442.                        2  : Green            10 : LightGreen
  5443.                        3  : Cyan             11 : LightCyan
  5444.                        4  : Red              12 : LightRed
  5445.                        5  : Magenta          13 : LightMagenta
  5446.                        6  : Brown            14 : Yellow
  5447.                        7  : LightGray        15 : White
  5448.  
  5449.                        You must supply  a value that  is made up  by the
  5450.                        foreground-color  and  background-color  with the
  5451.                        following formula:
  5452.  
  5453.                        Color = [Foreground] + 16 * [Background]
  5454.  
  5455.                        Only the values 0 to 7 can be used for the  back-
  5456.                        ground color. Also you  can add 128 to  the total
  5457.                        to force a blinking value !
  5458.  
  5459.                        [txtLow] This  is  the  low intensity text  color
  5460.                                 (common text). Default value is 3;
  5461.  
  5462.                        [txtHig] This  is the  high intensity  text color
  5463.                                 (common text). Default value is 11;
  5464.  
  5465.                        [Ok]     This is  the color to  display  ok-text.
  5466.                                 Default value is 10;
  5467.  
  5468.                        [Err]    This  is the  color to  display  errors.
  5469.                                 Default value is 12;
  5470.  
  5471.                        [Act]    This  is the  color to  display  special
  5472.                                 activity. Default value is 13;
  5473.  
  5474.                        [Fil]    This  is the  color to  display   files.
  5475.                                 Default value is 14;
  5476.  
  5477.          Local colors can  not be changed  (yet). Colors are  only shown
  5478.          when ANSI-support is used (so /ANS0 is not used).
  5479.  
  5480.  Relate: Remote
  5481.  Dest. : All
  5482.  
  5483.  
  5484.  3.3.9 Special statements
  5485.  ───────────────────────────────────────────────────────────────────────
  5486.  The following statements  are a collection  of statements that  can not
  5487.  be categorized in one of the other groups.
  5488.  
  5489.  ┌─────────────────────────────────────────────────────────────────────┐
  5490.  │ IncludeCtl [path]                                                   │
  5491.  └─────────────────────────────────────────────────────────────────────┘
  5492.  Usage : This parameter is optional. In MTA.CTL you can include one  (or
  5493.          several) other CTL-files. This comes in handy when you want  to
  5494.          separate  your  'normal'  run-time  options  and  the 'special'
  5495.          options you change much.
  5496.  
  5497.          MTA  can  handle  nested  IncludeCTL  statements.  So  you  can
  5498.          include 'IncludeCTL MTA.001' in your MTA.CTL and again you  can
  5499.          include  'IncludeCTL  MTA.002'  in  your  MTA.001.   The  total
  5500.          number of IncludeCTL options  (nested and in the  primary file)
  5501.          can be up to 16.
  5502.  
  5503.          [path]        This parameter must  point to the    control-file
  5504.                        you want to  include. The parameter  must contain
  5505.                        the drive, directory and filename.
  5506.  
  5507.  Relate: None
  5508.  Dest. : All
  5509.  
  5510.  
  5511.  3.3.10 Statements available when using a registered version
  5512.  ───────────────────────────────────────────────────────────────────────
  5513.  The following statements can  be used to define  one or more exits.  An
  5514.  exit a sort  of hook in  the MTA execution  process. The several  exits
  5515.  (hooks) are called at special places  while MTA is executing on one  or
  5516.  more files.  The user  can 'hook  into' the  process when  one or  more
  5517.  exits are defined in MTA.CTL.
  5518.  
  5519.  ┌─────────────────────────────────────────────────────────────────────┐
  5520.  │ RegistrationName [name]                                             │
  5521.  └─────────────────────────────────────────────────────────────────────┘
  5522.  Usage : This option  has only a meaning  when you received a  key after
  5523.          you registered MTA.  In ANY OTHER  case (non registered  usage)
  5524.          you must NOT include this option.
  5525.  
  5526.  Relate: None
  5527.  Dest. : All
  5528.  
  5529.  
  5530.  
  5531.  3.4 Diskette option
  5532.  ───────────────────────────────────────────────────────────────────────
  5533.  One of  the benefits  of MTA  is its  power to  convert diskettes  with
  5534.  great ease. This  method is only  functioning properly when  you have a
  5535.  PC with both floppy (FDU) and hard-disk (HDU).
  5536.  
  5537.  Most  users  with  hard-disks  will   have  a  collection  of   archive
  5538.  diskettes,  containing  their  (less)  used  software. When new archive
  5539.  systems are released  (or newer versions),  conversion of the  complete
  5540.  collection is sometimes needed (or wanted).
  5541.  
  5542.  You must activate MTA's diskette option with the /D switch. If you  do,
  5543.  MTA will start a conversion  cycle that can be interrupted  by pressing
  5544.  [ESC] when the next  diskette is finished. It  can be repeated for  the
  5545.  next diskette  when you  insert this  diskette into  the drive and when
  5546.  you press [ENTER].
  5547.  
  5548.  Which steps does MTA take to convert a diskette:
  5549.  
  5550.  - MTA  will read  all files  (the ones  matching the wildcard, normally
  5551.    you use the *.*  wildcard to select them  all) and will detect  which
  5552.    files are archives or not;
  5553.  
  5554.  - MTA will move (copy + delete) the archives to the directory that  you
  5555.    assigned  to  the  FDUTempPath  option.  If  you  also  supplied  the
  5556.    AllDisketteFiles option, MTA will also move all non-archive files  to
  5557.    that directory;
  5558.  
  5559.  - MTA  will convert  all archives  inside the  FDUTempPath directory to
  5560.    the new system or the higher release;
  5561.  
  5562.  - The exit ExitBeforeFill is called,  so you can do something with  the
  5563.    (empty if AllDisketteFiles was set) diskette (like a reformat);
  5564.  
  5565.  - Now  MTA will  sort the  converted (and  non-archive) files  based on
  5566.    size.  It  will  start  a  copy  for  each file, from the FDUTempPath
  5567.    directory (back) to  the diskette until  one of the  following events
  5568.    happens:
  5569.  
  5570.    - The diskette is full before the  last file is copied.  This can  be
  5571.      the  case  when  the  target  system  has  created  bigger files (a
  5572.      negative reduction); - The files are all moved;
  5573.  
  5574.    Depending on the type of event above, MTA will do the following:
  5575.  
  5576.    - When there are still files  left to copy back, MTA will  move these
  5577.      files to the directory you assigned in the FDUTrashPath option;
  5578.  
  5579.    - When all  files were moved  back to the  diskette and the  diskette
  5580.      still contains free space (you  had a positive reduction on  one or
  5581.      more archives), MTA  will look if  there is/are (a)  file(s) in the
  5582.      FDUTrashPath directory  that fit  on the  diskette. If  so, it will
  5583.      copy this(these) file(s) until the diskette is full or until  there
  5584.      are  no  files  left  that  will  fit  into  the  free space on the
  5585.      diskette;
  5586.  
  5587.  - MTA will now execute the ExitAfterFill EXIT if set;
  5588.  
  5589.  - MTA will ask for next diskette (or you press [ESC] to terminate);
  5590.  
  5591.  Please notice  that it  is possible  that MTA  leaves some files inside
  5592.  the FDUTrashPath  directory after  it has  finished. If  the number  of
  5593.  files  is  getting  to  big  (or  there  are  no more diskettes left to
  5594.  convert), insert an empty diskette in  the FDU and run MTA with  the /D
  5595.  option. Because  there are  no files  to convert,  MTA will  move files
  5596.  from the FDUTrashPath directory to this empty diskette. You can  repeat
  5597.  this  until  the  lower  threshold  is  reached  or until all files are
  5598.  moved.
  5599.  
  5600.  One final  word. As  you have  noticed (I  hope) you  can add unlimited
  5601.  power to  MTA's diskette  option with  the 'Before'  and 'After' exits.
  5602.  These  can  be  used  to  reformat  the diskette or something else (the
  5603.  'Before'  exit)  and/or  to  re-catalog  your  diskette  when you use a
  5604.  disk-catalog program (the 'After' exit).
  5605.  
  5606.  
  5607.  
  5608.  3.5 KeyBoard control
  5609.  ───────────────────────────────────────────────────────────────────────
  5610.  When MTA is executing you have control over some keyboard functions.
  5611.  
  5612.  When you  press [ESC]  (escape button),  MTA will  terminate AFTER  the
  5613.  current files is converted. When you  did hit [ESC] but you would  like
  5614.  to continue after all, you can do  so by hitting any other key.   Using
  5615.  the [ESC] key is not available  when you execute MTA with the  diskette
  5616.  option (/D).
  5617.  
  5618.  When you press [S], MTA will  start a DOS-shell, the moment it  is save
  5619.  to do so. This can be anywhere in the conversion phase. MTA will  place
  5620.  you in the  directory you started  MTA from. NEVER  alter files in  the
  5621.  temporary directory MTA  has created if  you do not  know what you  are
  5622.  doing. Also pressing  any other key  after [S], releases  the DOS-shell
  5623.  option as with [ESC].
  5624.  
  5625.  Pressing [T]  will cause  MTA to  toggle the  statistical display  from
  5626.  static  to  dynamic  mode  or  the  other  way around, depending on the
  5627.  default settings  (AltDisplay option).  You can  toggle as  much as you
  5628.  like while MTA is running. If you  run in a special text mode that  has
  5629.  more than  110 characters  for each  line, the  [T] button  is disabled
  5630.  because all possible screens are displayed.
  5631.  
  5632.  
  5633.  
  5634.  3.6 Running multiple copies of MTA at the same time
  5635.  ───────────────────────────────────────────────────────────────────────
  5636.  You ARE able to  execute multiple copies of  MTA at the same  time when
  5637.  you run a network or  a multitasking environment like DesqView  <tm> or
  5638.  MS-Windows <tm>.
  5639.  
  5640.  To  make  it  possible  for  MTA  to  execute concurrent, you take some
  5641.  special actions:
  5642.  
  5643.  - If you use the SubstDrive option, you must make sure you use as  many
  5644.    drive-letters in this option as you are going to run multiple  copies
  5645.    of MTA;
  5646.  
  5647.  - Make  sure  the  LASTDRIVE  option  is set along with the  SubstDrive
  5648.    option;
  5649.  
  5650.  - Make sure  you have SHARE.EXE  loaded in your  machine. Without SHARE
  5651.    MTA will make a mess of things (SURE !);
  5652.  
  5653.  - Make sure  that you run  all the concurrent  copies of MTA,  all with
  5654.    their  own  TASK-number.  You  assign  a  task  number with the /TASK
  5655.    command-line option. If  you forget this,  MTA will crash  because it
  5656.    will try to use the same substituted drive for each different task;
  5657.  
  5658.  After you have setup  MTA in the way  I described above, MTA  will give
  5659.  protection for some resources:
  5660.  
  5661.  - MTA will protect all the files it uses INTERNALLY;
  5662.  
  5663.  - All  log-files  (if  they  are  the  same in all copies of MTA),  all
  5664.    temporary  files,  all  directories  and  all  substituted drives are
  5665.    either unique to the task or SHARE'ed with all other tasks;
  5666.  
  5667.  - All  external files  (like the  FILES.BBS-alike files)  are protected
  5668.    when  they  are  altered.  This  means  that these files are SHARE'ed
  5669.    within the  multiple copies  of MTA  but also  with other  tasks that
  5670.    have SHAREing options like SOME Bulletin Board Systems;
  5671.  
  5672.  - When  two MTA's  want to  access the  same file  at the same time and
  5673.    with different attributes (one WRITE,  one READ for example), one  of
  5674.    the tasks will wait until the  file is released again. To over-  come
  5675.    problems with 'eternal  waits' (called deadlocks)  you can in-  stall
  5676.    an option in MTA.CTL that will manage the maximum time MTA will  wait
  5677.    before aborting. Waiting for allocation  of a file, will also  be the
  5678.    case  with  external  files,  provided  the  'other'  task  has  used
  5679.    SHAREing attributes with the open of that file. If you want to  abort
  5680.    the waiting (and MTA along the way), you can press [CTRL-E]. In  that
  5681.    case the 'deadlock' is released an MTA will abort;
  5682.  
  5683.  Some resources can NOT be protected by MTA:
  5684.  
  5685.  - MTA  will NOT  manage anything  that happens  within the  shell's. So
  5686.    when  the  (de)compressors  run  or  when  you  are within one of the
  5687.    supplied exits,  the called  program has  to manage  the SHAREing  by
  5688.    itself.
  5689.  
  5690.  It is almost stupid to say,  but be sure to convert different  files in
  5691.  each of the copies  of MTA. Letting two  or more copies of  MTA convert
  5692.  the same files, will cause  trouble. Though SHAREing is managed,  there
  5693.  could be  cases where  MTA is  waiting for  a file  (it will do so) and
  5694.  when this MTA gets the 'GO' signal, the file could be gone  (temporary)
  5695.  because one of the other copies of MTA is working on that file.
  5696.  
  5697.  Running  multiple  MTA's   in  a  multitasking   environment  works but
  5698.  there is a  big tradeoff. When  you don't have  enough 'power' on  your
  5699.  machine,  running  two  concurrent   copies  could  take   as  long  as
  5700.  serially running these copies.  (De)compressors  are  in the  habit  to
  5701.  eat lots  of your cycles. The multi-tasker also wants to have a  little
  5702.  snack and all   are eating   more  food   than  the   PC  can   supply,
  5703.  causing  delays,    low performance and   so on.  I  have  tested  with
  5704.  several machines, but you need  at  least a   true 386-25  (or a   very
  5705.  fast  286, like  a 20Mh)  or  higher to get  good results. But  in  the
  5706.  world  where these options  of MTA   are   needed,  machine-power    is
  5707.  usually  available. Also,  when you  run   MTA   concurrent  and    you
  5708.  use   only  the   /SIM   option, performance  is  not  so  very    much
  5709.  affected  because   MTA will only perform  a decompress (usually   this
  5710.  is very   fast).  This is the    case when you  run    MTA as  an  exit
  5711.  under some  BBS program (like FileDoor <tm>).
  5712.  
  5713.  
  5714.  3.7 Compression of single executable files (PKLITE)
  5715.  ───────────────────────────────────────────────────────────────────────
  5716.  With this version  of MTA, you  can also use  MTA to do  conversions of
  5717.  executable files to compressed  (self contained) executable files  with
  5718.  PKLITE. This feature merely comes as a bonus to the program.
  5719.  
  5720.  MTA's main  goal is  to convert  archives from  a certain  system to  a
  5721.  system you  like. The  compression of  EXE/COM files  can be  used as a
  5722.  separate function.
  5723.  
  5724.  Most of the  MTA.CTL statements have  no meaning to  this type of  con-
  5725.  version. You  can setup  MTA to  do nothing  BUT conversion  of COM/EXE
  5726.  files when  you set  the CompressionType  option to  PKLITE or UNPKLITE
  5727.  but in this case you only use around 10% of the programs functions.
  5728.  
  5729.  In most cases you setup  MTA to do a archive-to-archive  conversion and
  5730.  you set CompressionType to the system  you like. If you have setup  MTA
  5731.  like this (along with all possible  options), you can still use MTA  to
  5732.  convert  COM/EXE  files  by  including   /PKLITE  or  /UNPKLITE  as   a
  5733.  command-line parameter when you call  MTA. MTA will ignore all  options
  5734.  that have  nothing to  do with  the conversion  of executable files and
  5735.  will convert COM/EXE files from normal to PKLITE or back.
  5736.  
  5737.  I did not  include LZEXE because  the latest version  I have seen  can,
  5738.  only convert from normal to LZEXE'ed and not back.  There are  programs
  5739.  that can do the reversed (LZEXE'ed to normal) but there are at least  3
  5740.  I have seen and I can not create a protected and generalized  interface
  5741.  to all of them  (also because 2 of  them come as a  shell and not as  a
  5742.  stand-alone program). This does not  mean that MTA is not  LZEXE-aware.
  5743.  When  selecting  files,  MTA  takes  into  account if a COM/EXE file is
  5744.  already compressed with LZEXE (0.90 or 0.91) and will skip the file  in
  5745.  that case. When decompressing,  MTA will only select  PKLITE-compressed
  5746.  COM/EXE files.
  5747.  
  5748.  When  you  run  MTA  without  any  file-mask,  but  WITH the /PKLITE or
  5749.  /UNPKLITE  option  (or  CompressionType  set  to  one  of  both),   the
  5750.  tag-window will also change and  will only display available files  for
  5751.  this type compression.
  5752.  
  5753.  A file is available (and usable by MTA) for PKLITE if:
  5754.  
  5755.  - It is a COM or EXE file;
  5756.  
  5757.  - If it is not compressed with PKLITE, LZEXE 0.90 or LZEXE 0.91;
  5758.  
  5759.  - If  it is  not a  self-extracting archive  (SFX) of  any of the known
  5760.    archive systems;
  5761.  
  5762.  A file is available (and usable by MTA) for UNPKLITE if:
  5763.  
  5764.  - It is a COM or EXE file;
  5765.  
  5766.  - It is compressed with PKLITE;
  5767.  
  5768.  
  5769.  3.8 The MTA tag-window
  5770.  ───────────────────────────────────────────────────────────────────────
  5771.  When you  run MTA  without any  file-masks on  the command-line,  a tag
  5772.  menu is displayed. In this tag-menu  you have the option to tag  inside
  5773.  only ONE directory. A mix of files in several different directories  is
  5774.  impossible then you use the full-screen tag.
  5775.  
  5776.  When the  tag-menu is  displayed, you  CAN switch  to other directories
  5777.  and even to  other drives. If  one or more  of the displayed  drives is
  5778.  not  available  (not  ready,  door  open,  unformatted  disk) it can be
  5779.  selected but the  tag-window will ignore  it after it  has detected any
  5780.  error on that drive. In that case you must select another drive.
  5781.  
  5782.  When you  start MTA  with SFX  support (so  you include self extracting
  5783.  archives), all files  with abnormal extensions  and COM/EXE files  that
  5784.  are  SFX-files,  will  be  included.  The  testing  will  take a while,
  5785.  depending on the speed of the drive and the machine you have.
  5786.  
  5787.  If you start MTA with the PKLITE or UNPKLITE option, all available  AND
  5788.  usable files are  displayed (so only  decompressed executable files  or
  5789.  executable files, compressed with PKLITE).
  5790.  
  5791.  If you start MTA with the GIFLITE option, all available GIF files  that
  5792.  are not  already processed  by GIFLITE  (AND which  are valid  for MTA,
  5793.  based on the MaxGIFDim option) will be shown.
  5794.  
  5795.  If you start MTA with the GIF option, all available GIF files  that are
  5796.  present will be shown (normal AND GIFLITE).
  5797.  
  5798.  If  you  start  MTA  with  the  GIF2JPG option, all available GIF files
  5799.  (again with respect  to the MaxGifDim  option) are displayed.  When you
  5800.  used the JPG2GIF option, MTA will only show (all available) JPG files.
  5801.  
  5802.  
  5803.  
  5804.  3.9 MTA and unattended operations
  5805.  ───────────────────────────────────────────────────────────────────────
  5806.  There are a number of options that influence the way that MTA works  in
  5807.  unattended mode. Most of them you  can find out when the need  is there
  5808.  but some must be pointed out.
  5809.  
  5810.  In most cases  you will do  an unattended MTA  on the same  directories
  5811.  each time over and over. First I must point out the way you must  setup
  5812.  MTA to work in the right directories. This can be done in one of the  3
  5813.  following ways:
  5814.  
  5815.  - Put the  MTA in a  batch-file, change to  the right directory  before
  5816.    you call  MTA and  call MTA  with its  options (see  later). You  can
  5817.    repeat this for every directory. For example:
  5818.  
  5819.    ..
  5820.    ..
  5821.    D:
  5822.    CD \ZIP1
  5823.    MTA [parameters]
  5824.    E:
  5825.    CD \ZIP2
  5826.    MTA [parameters]
  5827.    ..
  5828.    ..
  5829.  
  5830.    To work on \ZIP1 on D: and \ZIP2 on E:;
  5831.  
  5832.  - Make the batch smaller and  use DefaultPath options in MTA.CTL.   You
  5833.    include DefaultPath  D:\ZIP1 and  DefaultPath E:\ZIP2  in MTA.CTL and
  5834.    you can reduce the previous batch to:
  5835.  
  5836.    ..
  5837.    ..
  5838.    MTA [parameters]
  5839.    ..
  5840.    ..
  5841.  
  5842.    To work on those two directories again;
  5843.  
  5844.  - You  would like  to run  MTA on  all your  directories of  a BBS. MTA
  5845.    supports both QuickBBS  <tm> and Remote  Access <tm> BBS  types.  You
  5846.    include either the  QBBSPaths option or  the RAPaths option.   Inside
  5847.    the batch you do:
  5848.  
  5849.    ..
  5850.    ..
  5851.    MTA [parameters]
  5852.    ..
  5853.    ..
  5854.  
  5855.    And MTA will work on all files in all BBS directories.
  5856.  
  5857.  Now the next problem. You must tel  MTA to work on some files. You  can
  5858.  do this in two different ways:
  5859.  
  5860.  - Use file-masks for [parameters].  In the previous examples you  could
  5861.    tell MTA to convert  all *.ZIP and *.LZH  files (ARJ is your  target)
  5862.    with  'MTA  *.ZIP  *.LZH'  and  MTA  will convert all *.ZIP and *.LZH
  5863.    files in the supplied directories;
  5864.  
  5865.  - Use  the MarkString  and NoMarked  options (or  /MAS and  /MAR on the
  5866.    command-line).  This is a better option. In the previous example  you
  5867.    would have  problems when  someone uploaded  a *.LZS  or *.ARC  file.
  5868.    These would  not be  converted. If  you used  *.* ALL  files would be
  5869.    converted   even    those   that    you   converted    earlier    !!!
  5870.    NoMarked can be used to tell  MTA only to convert files that  confirm
  5871.    to the supplied mask AND that  are not converted before. So with  the
  5872.    NoMarked and MarkString options set,  the call to MTA can  be changed
  5873.    to 'MTA  *.*'. Only  those files  that are  not converted  before are
  5874.    converted and will not be converted again until you set the  NoMarked
  5875.    option to OFF;
  5876.  
  5877.  - Use the OnlyNewFiles option (see the description of this option);
  5878.  
  5879.  Finally there are  some options that  you must change  or include. When
  5880.  you run MTA  in unattended mode  but you don't  want MTA to  run longer
  5881.  than a  certain amount  of time  (BBS events  !!) you  can include  the
  5882.  RunTime option to limit the number of minutes that MTA can run.
  5883.  
  5884.  Remember that MTA  will start in  a new archive  even when 1  second is
  5885.  left, so  you can  outrun the  RunTime by  the time  that your  machine
  5886.  needs to convert the last archive.
  5887.  
  5888.  Sometimes you can  get frequent warnings  on some files.  In unattended
  5889.  mode these  warnings won't  be seen,  neither do  you want  to hear the
  5890.  beeping, so put a value of  0 to the WarningTime option. All  important
  5891.  things are logged (when you put  on the logging). You can also  use the
  5892.  NoBeep option to  make the execution  of MTA more  quiet. When you  run
  5893.  MTA  as  an  exit  under  a  door  (FileDoor <tm>), you should keep the
  5894.  WarningTime option (set to 1 or  higher) and you should use the  NoBeep
  5895.  option. If you set  Warningtime to 0 in  this case, the user  won't see
  5896.  any error messages !
  5897.  
  5898.  REMEMBER. ALWAYS include  a file-mask. To  call MTA without  parameters
  5899.  in unattended mode will force MTA  to display the tag-menu and to  wait
  5900.  until you enter the files.
  5901.  
  5902.  
  5903.  
  5904.  3.10 TICK files and related material
  5905.  ───────────────────────────────────────────────────────────────────────
  5906.  As you know by now, there are several options that deal with TICK  (and
  5907.  its  clone  FES)  files.  I  won't  go  into the TICKFILES option. This
  5908.  option is described in detail in the CTL-section and is only  important
  5909.  with incoming files.
  5910.  
  5911.  It  becomes  different  with  TICK/FES  files  that  are  outbound ! In
  5912.  general you  have the  following problems  when you  run MTA over files
  5913.  that are also the subject of an outgoing TICK/FES file:
  5914.  
  5915.  - The messages that are generated by TICK and FES, contain the name  of
  5916.    the archive. With a conversion from  ARC to ZIP, this will cause  the
  5917.    file to be renamed from A.ARC  to A.ZIP but the messages generated by
  5918.    TICK/FES still contain A.ARC !
  5919.  
  5920.  - The TICK/FES files  ALSO contain the name  A.ARC, so that is  another
  5921.    problem;
  5922.  
  5923.  - The TICK/FES files also contain  the CRC of the A.ARC file.  Obvious,
  5924.    when you convert  A.ARC to A.ZIP,  the CRC will  also be changed  but
  5925.    the TICK/FES files still contain the old CRC;
  5926.  
  5927.  MTA  can  deal  with  all  these  problems.  You  must  use a number of
  5928.  special options to  do so  (using  them  will cause  some overhead   on
  5929.  MTA)  but after implementing them,  you won't  have any trouble  with a
  5930.  conversion of  a file  that   is also  subject of   a TICK/FES file. In
  5931.  general, these options can also deal with other products than  TICK/FES
  5932.  if they  work in the same way.
  5933.  
  5934.  The following options must be set and will do the following:
  5935.  
  5936.  - UpdateTICKFiles and/or UpdateFESFiles
  5937.    You can add up  to 10 of EACH  options all pointing to  file-masks in
  5938.    certain directories. When you have set  up the BBS is a way  that you
  5939.    support different  TICK/FES outbound  directories for  different nets
  5940.    (or zones), you must point to all of them, for example:
  5941.  
  5942.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE1\*.TIC
  5943.    UpDateFESFiles  D:\MAILER\OUTBOUND\TICZONE1\*.FES
  5944.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE2\*.TIC
  5945.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE5\*.TIC
  5946.  
  5947.    When A.ARC is  converted  to  A.ZIP, MTA will   scan ALL these  files
  5948.    in the  supplied directories  and search   for hits  for A.ARC.  When
  5949.    found, A.ARC  is changed  in A.ZIP.   The TICK/FES  files are changed
  5950.    as binary  files. MTA  reads up  to 16K  of data  per file and does a
  5951.    search  on   the  changed  item.  As  a   result  of this, it  is NOT
  5952.    possible  to   use  these  options  when  the   file-name  length  is
  5953.    changed. So  a   conversion from  A.MD to  A.ARC and  reversed is NOT
  5954.    supported. The changed  files  don't  have  to   be  TICK/FES   files
  5955.    but  these  files contain the filename (obvious).  If  your   product
  5956.    also  creates  a  file  with a filename inside, MTA can still  do the
  5957.    job !
  5958.  
  5959. │Now  you  have  a choice either to use the UpdateUntypedFiles option OR
  5960. │the UpdateMSGFiles option. The choice depends on the number of messages
  5961. │that are  normally  inside the MSG-directory. If this are many messages
  5962. │(100 or more), you  should  use  the UpdateMSGFiles option. If it are a
  5963. │small number of messages, you should use the UpdateUntypedFiles option.
  5964. │The UpdateUntypedFiles  option  will update very fast but will slowdown
  5965. │MTA when there are many files (*.MSG files in this case) to search thru
  5966. │after each conversion. The  UpdateMSGFiles  is somewhat slower than the
  5967. │UpdateUntypedFiles  option  but will benefit from the fact that it only
  5968. │has to search ALL  messages  ONCE and will then update ONLY THE RELATED
  5969. │files. I will describe both:
  5970.  
  5971.  - UpdateUntypedFiles
  5972.    You can add up to 10 of these options. In our TICK/FES example,  this
  5973.    option must point to the  netmail directory (outbound) be- cause  the
  5974.    *.MSG files must also be changed. For example:
  5975.  
  5976.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE1\*.MSG
  5977.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE2\*.MSG
  5978.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE5\*.MSG
  5979.  
  5980.    MTA will do the same with these files (obvious they are the  outbound
  5981.    messages). This option differs from  the previous 2 in the  fact that
  5982.    UpdateTICKFiles and UpdateFESFiles ALSO  change the CRC (32-bit  CRC)
  5983.    of the files and this option ONLY the file names;
  5984.  
  5985. │- UpdateMSGFiles
  5986. │  You can add up to 255 of these options. In our TICK/FES example, this
  5987. │  option must point to the netmail directory (outbound) where the *.MSG
  5988. │  files will be. For example:
  5989. │
  5990. │  UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE1\
  5991. │  UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE2\
  5992. │  UpDateMSGFiles D:\MAILER\OUTBOUND\TICZONE5\
  5993. │
  5994. │  The result  of  these  options  will  be  the same as in the previous
  5995. │  example  for  the  UpdateUntypedFiles  option  BUT  will  work  in  a
  5996. │  different  way.  Where  UpdateUntypedFiles  will scan ALL *.MSG files
  5997. │  after EVERY  converted  files  (this  can  slow down the process when
  5998. │  there are MANY messages to  search thru), UpdateMSGFiles will work in
  5999. │  he following way:
  6000. │
  6001. │  - When MTA starts, MTA will  look  in ALL CONFIGURES message areas (3
  6002. │    in the case of our previous example, can be up to 255);
  6003. │
  6004. │  - For  every  area  whete there is at least ONE message found with an
  6005. │    attached  file, MTA will create a record in a special file which is
  6006. │    called  MTA$$$$$.MFA  (in  the  current  directory or the directory
  6007. │    pointed to by the MTATEMPPATH option);
  6008. │
  6009. │  - Each  record can contain information for message numbers 1 to 65000
  6010. │    which would be enough;
  6011. │
  6012. │  - Now AFTER  the  conversion  of EVERY file, MTA will search thru the
  6013. │    MTA$$$$$.MFA file and  will  only  try  to change the messages that
  6014. │    have attached  files  in  the message. The change will only be done
  6015. │    when the filename of the  old file (f.i. A.ARC) will match the name
  6016. │    in the message;
  6017. │
  6018. │  - Before  termination, MTA  will  delete the MTA$$$$$.MFA file again;
  6019. │
  6020. │  With this  flow  of  action, MTA will only have to check the messages
  6021. │  that have files attached to them, which will normally be only a small
  6022. │  percentage of the total number of messages.
  6023. │
  6024. │
  6025. │When you use the UpdateTICKFiles/UpdateFESFiles options in combination
  6026. │with the UpdateUntypedFiles/UpdateMSGFiles options to update your TICK
  6027. │or FES files (incomming and outgoing), you  should also set one of the
  6028. │two related options UpdateUntypedFULL or UpdateMSGFull.
  6029.  
  6030.  DON'T   use   this   options   when   you   don't  work with a TICK/FES
  6031.  alike  complex.    When   UpdateTICKFiles      and/or    UpdateFESFiles
  6032.  options    are present  in   MTA.CTL, MTA   will ALWAYS   calculate the
  6033.  32-bit CRC of the  source  and   the  target.   This  causes   overhead
  6034.  when there are never updates for  TICK or  FES files.  The 32-bit   CRC
  6035.  is  fast but on a big number of  files  it will still  count ! If   you
  6036.  have TICK  or FES files that  are BIGGER than 16K, please  contact  me.
  6037.  I can change MTA   to make it compatible with  files up to 64K, but  it
  6038.  will cause memory  overhead.   Only when  your seen-by   lines are   to
  6039.  many  to mention, these problems will occur !
  6040.  
  6041.  
  6042.  
  6043.  3.11 FES, yet another TICK-clone ?
  6044.  ───────────────────────────────────────────────────────────────────────
  6045.  By now you will  have seen the   word FES  several  times. In zone   2,
  6046.  net 24x, most  of the  people know  FES. FES  looks like  a  TICK-clone
  6047.  but  implements  some  nice  features   (including  its  own  type   of
  6048.  communication files,  called  *.FES)  that  are  not  found  in   TICK.
  6049.  FES  is   already  released    but   development    goes    on.    Most
  6050.  eye-catching   is the  HATCH procedure  that gives  you a user-friendly
  6051.  interface between your   files, FILES.BBS (in  AND out) and   yourself.
  6052.  FES can optionally create  FES or TICK files for a given node.
  6053.  
  6054.  If TICK is  all you want,  stay with   TICK or take  a peek at  FES. If
  6055.  you are doing distribution yourself  (so adding new files to  a chain),
  6056.  like I do,  FES could  be it.   Also, if  you have  nodes that  want  a
  6057.  large number  of files   from certain  area's,   FES can  also  come in
  6058.  handy  and there is even a FESFix option to obtain files from remote.
  6059.  
  6060.  FES can be  obtained from several  german BBS's and  the author can  be
  6061.  contacted thru FidoNet.
  6062.  
  6063.  
  6064.  
  6065.  3.12 Special ARC considerations
  6066.  ───────────────────────────────────────────────────────────────────────
  6067.  There  are   a  few   special  ARC-files.   These  are   the files that
  6068.  are normally created with a clone of ARC or with ARC 7.xx (or  whatever
  6069.  SEA likes  to  call  it).  In  MOST  cases,  these  archives  can   not
  6070.  be decompressed   with  ARC,   PAK  or   PKUNPAK  but   need a  special
  6071.  kind of program.
  6072.  
  6073.  So far  I   have NO  information   about SEA's  new   archiver and that
  6074.  will stay  that  way   unless  either  SEA   or  someone else can  give
  6075.  me full details  about  the   operation  of  this  program. Until  that
  6076.  time, SEA  eXtended   (7.xx)   archives   will   NOT   be  supported as
  6077.  OUTPUT (target) files.
  6078.  
  6079.  There  ARE  is  a   special  program  that  is   able  to EXTRACT these
  6080.  special type of   archives. It   is called   XARC.EXE and   is released
  6081.  by SEA  for PD/Shareware  (??) usage.  XARC   must be  executed without
  6082.  any parameters and  is therefore not  suitable to be  included in MTA's
  6083.  ARCPath option !
  6084.  
  6085.  The same  story goes  for some   very old  types of  archives that  are
  6086.  more or  less compatible  to the  older   ARC. An  example is the older
  6087.  ARCA and its counterpart  ARCE but  these files  will, in  general,  be
  6088.  available for decompress with ARC, PAK or PKUNPAK.
  6089.  
  6090.  From  my  point  of  view,  it  is  very difficult to support all these
  6091.  non-standard formats.   But to make  it more flexible,  I have included
  6092.  ONE options  that makes  it possible  to use  a special  un-arc program
  6093.  that will be used  for all ARC-alike archives.   You could even call  a
  6094.  special  shell  program  that  can  see  the  difference  between   all
  6095.  ARC-formats  (I  do  NOT  mean  the  difference  between  ARC,  PAK and
  6096.  PKUNPAK, MTA  can see  this for  itself) and  calls the  correct un-ARC
  6097.  procedure for  the supplied  archives.   This option  is the  UNARCPath
  6098.  option.   The program  that is  supplied in  this option  will ONLY  be
  6099.  called   for    DECOMPRESSION   and    is   called    as    PROGRAM.EXT
  6100.  DRIVE:\PATH\ARCHIVEN.AME  (no  options,  only   the  archive  and   its
  6101.  location is presented in the call).
  6102.  
  6103.  The  UNARCPATH  option  is  designed  to  be used with XARC.EXE or with
  6104.  ARCE.EXE/ARCE.COM when you don't expect eXtended SEA archives !
  6105.  
  6106.  If you include the following:
  6107.  
  6108.  ARCPATH   C:\ARC\ARC.EXE  [rest of MTA-parameters]
  6109.  UNARCPATH C:\ARC\XARC.EXE [rest of MTA-parameters]
  6110.  
  6111.  The following will happen  when MTA is called  to convert A.ARC to  the
  6112.  ARC format:
  6113.  
  6114.  - XARC.EXE (or its substitute) is called for decompress;
  6115.  - ARC.EXE  (or its substitute) is called for compress;
  6116.  
  6117.  The following will happen  when MTA is called  to convert A.ARC to  the
  6118.  ZIP (or any NON-ARC) format:
  6119.  
  6120.  - XARC.EXE  (or its substitute) is called for decompress;
  6121.  - PKZIP.EXE (or its substitute) is called for compress;
  6122.  
  6123.  Now the same  sequences without UNARCPath  set and without  XARC.EXE in
  6124.  your DOS-path:
  6125.  
  6126.  - ARC.EXE  (or its substitute) is called for decompress;
  6127.  - ARC.EXE  (or its substitute) is called for compress;
  6128.  
  6129.  and
  6130.  
  6131.  - ARC.EXE   (or its substitute) is called for decompress;
  6132.  - PKZIP.EXE (or its substitute) is called for compress;
  6133.  
  6134.  The latter can  result in errors  when A.ARC is  a SEA eXtended  (7.xx)
  6135.  archive. The first examples will run fine !
  6136.  
  6137.  If you think this is all, then read on. It will become rather messy.
  6138.  In their development, NoGate (PAK) and SEA (ARC) have both found it
  6139.  the correct procedure to keep the internal archive format the same
  6140.  (understandable, you will be backward compatible), but they both use
  6141.  the archive version-number 10 (and maybe higher on SEA's format, but
  6142.  information is not available to me) for their extended format. In the
  6143.  NoGate version, 10 is crushed, in the SEA format, 10 is something else
  6144.  (eXtended in any case because XARC can decompress it). Now see what
  6145.  happens with A.ARC (an eXtended archive, containing 10 files, created
  6146.  with ARC 7.xx):
  6147.  
  6148.  - A.ARC contains 10 files all with code 10;
  6149.  
  6150.  - Code 10 is PAK crushed;
  6151.  
  6152.  - PAK.EXE with extract is called to decompress the archive;
  6153.  
  6154.  - The  result is  an archive  in error  and not  converted because  PAK
  6155.    terminates with error 'CRC error in data' or something else;
  6156.  
  6157.  Nothing can keep me from thinking that the same COULD also be the  case
  6158.  for code 11 (NoGate destilled, SEA  whatever) or even higher !   In any
  6159.  case it is a complete mess and  about 10K of coding in MTA is  consumed
  6160.  by these  little jokes.  The actual  victims are  the users who receive
  6161.  ARC 7.xx files AND PAK files.  Our dear friends in the SDN/SDS  circuit
  6162.  to name but a few !
  6163.  
  6164.  MTA fixes the problem with the ARC-version 10 and 11 with a rather  Q&D
  6165.  solution.  When  PAKPath  AND  UNARCPath  are available in MTA.CTL, MTA
  6166.  will  first  call  PAK  with  the  T  (test)  option.  If the resulting
  6167.  errorlevel is  not 0,  MTA will  use the  program you  supplied in  the
  6168.  UNARCPath option  (e.g. XARC.EXE).  If the  resulting errorlevel equals
  6169.  0, MTA will use  the program you supplied  in the PAKPath option  (e.g.
  6170.  PAK.EXE).
  6171.  
  6172.  When the PAKPAth option is NOT available and PAK.EXE is not in the  DOS
  6173.  path but A.ARC  contains files with  archive-code 10, MTA  will use the
  6174.  program supplied in UNARCPATH by default, EVEN when A.ARC was a  NoGate
  6175.  archive with crushed  files (in which  case the decompress  will result
  6176.  in an error).  When the PAKPath  option IS available  but the UNARCPath
  6177.  option is NOT, A.ARC will be  marked as a NoGate archive (even  when it
  6178.  is SEA  eXtended) and  the program  supplied in  the PAKPath  option is
  6179.  used (resulting in an  error when A.ARC was  SEA eXtended).  When  BOTH
  6180.  are NOT supplied,  MTA will give  an error because  neither PAKPath nor
  6181.  UNARCPath are present.
  6182.  
  6183.  The special  dirty tricks  that must  be executed  on these  files will
  6184.  result  in  somewhat  overhead  but  should  work full-proof. Because I
  6185.  dislike 2 versions per  day, I do the  same with archives that  contain
  6186.  only ARC-version 11 files). Normal  users should not use the  UNARCPath
  6187.  option  UNLESS  they  got  trouble.  SDS/SDN  sysops will have no other
  6188.  choice than to include them (in general).
  6189.  
  6190.  You can make up your own mind about all these special tricks that  must
  6191.  be executed to serialize an archive  in the correct way. I myself  find
  6192.  it rather strange that these mixups are created in the first place.
  6193.  
  6194.  
  6195.  3.13 Using newer versions of archivers
  6196.  ───────────────────────────────────────────────────────────────────────
  6197.  Once in a while you receive new versions of the archivers that you  use
  6198.  (or don't use). In  some cases, it is  quit a risk to  start converting
  6199.  all  files  to  the  new  version  (certainly  when  you  receive  beta
  6200.  versions) and in some other cases  you would like to see if  a specific
  6201.  new option is indeed working and giving you the expected result.
  6202.  
  6203.  UNLESS the  internal format  of the  archive is  changed, MTA  can work
  6204.  with a ALTernate set of  archive-program versions. This comes in  handy
  6205.  when you want to test the new version on various files but in the  mean
  6206.  while  you  would  like  to  convert  all  other  files  with the older
  6207.  version.
  6208.  
  6209.  All you have to do is the following:
  6210.  
  6211.  - Rename the new version (for example, you receive PKZIP/PKUNZIP  2.0ß,
  6212.    in  which  case   you  could  rename   PKZIP.EXE  to  P2ZIP.EXE   and
  6213.    PKUNZIP.EXE to P2UNZIP.EXE);
  6214.  
  6215.  - Alter the xxxPath option(s) in MTA.CTL. You must add the path to  the
  6216.    new version as the LAST parameter in the option. In this example  you
  6217.    add the path, C:\ARC\P2ZIP.EXE to  the PKZIPPath option and also  you
  6218.    add  C:\ARC\P2UNZIP.EXE  to  the  PKUNZIPPath  option. They will look
  6219.    something like:
  6220.  
  6221.    PKZIPPath   C:\ARC.PKZIP.EXE   N 200 C:\ARC\P2ZIP.EXE
  6222.    PKUNZIPPath C:\ARC.PKUNZIP.EXE N 200 C:\ARC\P2UNZIP.EXE
  6223.  
  6224.    You can do this for each and every archiver (GIF-conversion  program)
  6225.    you use;
  6226.  
  6227.  - Alter the xxxVersion option in  MTA.CTL. You must add the version  of
  6228.    the new release as the second parameter to the xxxVersion  option(s).
  6229.    In the example, you  normally use PKZIP 1.10  and will start to  test
  6230.    the PKZIP 2.01. In  this case you change  ZIPVersion so it will  have
  6231.    both values showed (ZIPVersion 110 201);
  6232.  
  6233.  When you are finished with the  changes, you can execute MTA as  normal
  6234.  to get  the 'normal'  versions of  all archivers.  When you execute MTA
  6235.  with  the  (optional)  /ALT  command-line  parameter,  MTA will look if
  6236.  there is  a second  path available  inside the  xxxPath option and will
  6237.  use THAT one.  If it is  not set, MTA  will use the  original path from
  6238.  this option (e.g. there is no new version present). After this  routine
  6239.  is  finished,  MTA  will  look  if  there  is a second value set in the
  6240.  xxxVersion. If so, MTA will use that one, otherwise the original  value
  6241.  (or the default value) is used. With our example and in short:
  6242.  
  6243.  MTA *.*         will convert files, using  PKZIP/PKUNZIP (1.10)    when
  6244.                  needed, to the format you have set;
  6245.  
  6246.  MTA *.* /ALT    will  convert files, using  P2ZIP/P2UNZIP (2.01)   when
  6247.                  needed, to the format you have set;
  6248.  
  6249.  
  6250.  3.14 Lo-tek functions, calling MTA as shell under MTA
  6251.  ───────────────────────────────────────────────────────────────────────
  6252.  MTA can only call itself as  a  child (to work on arc-in-arc files). If
  6253.  you try to run MTA as a shell  of  MTA (e.g. you press [S] to shell out
  6254.  if MTA and start MTA again),  you will get a message and the second MTA
  6255.  will abort.
  6256.  
  6257.  This coding is present for a  various  number of reasons (one of the is
  6258.  the usage of SUBST functions). If  for  some reason these functions can
  6259.  not be used, MTA will give a 'lo-tek' warning  and will perform various
  6260.  other tests  to  make  sure  that  it's  own working-environment is not
  6261.  trashed by other tasks.
  6262.  
  6263.  
  6264.  3.15 TEC files
  6265.  ───────────────────────────────────────────────────────────────────────
  6266.  With every release, one or more *.TEC files will be supplied. These TEC
  6267.  files will each go deeper into some delicate subjects. The TEC files
  6268.  are based upon the most frequently asked questions. These problems can
  6269.  range from examples for simple setups to discussions about comments in
  6270.  archives.
  6271.  
  6272.  ┌───────┬─────────────────────────────────────────────────────────────┐
  6273.  │   4   │ Runtime information                                         │
  6274.  └───────┴─────────────────────────────────────────────────────────────┘
  6275.  
  6276.  4.1 Command-line parameters
  6277.  ───────────────────────────────────────────────────────────────────────
  6278.  Most of  the information  that MTA  needs is  obtained from the MTA.CTL
  6279.  configuration  file.  When  you  want  to  change  one (or some) of the
  6280.  options temporary, you can use command-line parameters to do so.
  6281.  
  6282.  The syntax to start execution of MTA is:
  6283.  
  6284.  MTA {filespec} {filespec}..{filespec} {CMD} {CMD}..{CMD}
  6285.  
  6286.  {filespec} is  the  optional  wildcard  (or complete filename) you  can
  6287.             supply. You can supply up  to 25 {filespec} values. You  can
  6288.             use the normal DOS  wildcards AND the special  wildcard that
  6289.             is supplied in  almost ALL DISP-programs.  This is the  '='.
  6290.             This wildcard  can be  used for  a shifted  test. =MTA  will
  6291.             select  files   with  the   names  doMTA.bat,   MTAtest.zip,
  6292.             newMTA.me. If you want to  include the '.', you MUST  supply
  6293.             it in the wildcard. =A.Z will include mtaA.Zip and so on.
  6294.  
  6295.             If you do  not supply a  {filespec} a full-screen  menu will
  6296.             be  shown.  This  menu  can  be  used to select files in ONE
  6297.             directory.
  6298.  
  6299.  {CMD}      You  can  (optionally)   supply  one  or more   command-line
  6300.             options  when  you  execute  MTA.  Some  of  the work like a
  6301.             toggle, some  of the  overrule options  in MTA.CTL,  some of
  6302.             them can only switch on or off in MTA.CTL.
  6303.  
  6304.             In general, the /STOSIZ, /STOCOM and /STONAM toggles work in
  6305.             the old-fashioned way, command-line options that work like a
  6306.             toggle, can be supplied in two different ways:
  6307.  
  6308.             - /CMDOPT
  6309.               With this format  you  reverse  (toggle) the option in the
  6310.               MTA.CTL file  but  you need to know for sure in what state
  6311.               the option  in  MTA.CTL  is. In  other  words, if  the FOO
  6312.               option  is set in  MTA.CTL, /FOO will switch is off. If it
  6313.               was off in MTA.CTL, /FOO will switch it to on;
  6314.  
  6315.             - /CMDOPT+ or /CMDOPT-
  6316.               With  this  format  you can explicitly switch an option on
  6317.               (with /COMOPT+)  or off (with /CMDOPT-). You don't need to
  6318.               know in what state the option in MTA.CTL is;
  6319.  
  6320.             The three switches mentioned earlier (/STONAM, /STOSIZ and
  6321.             /STOCOM) work in the old way (+ or - is NOT possible). This
  6322.             is the result of the extended format (where a name can be
  6323.             supplied along with the command-line option).
  6324.  
  6325.             A  command-line  parameter  must  start  with a slash ('/').
  6326.             Multiple command-line parameters  must be separated  with at
  6327.             least one  space. If  the command-line  parameter has  extra
  6328.             values, the  must follow  the parameter  itself WITHOUT  any
  6329.             spaces between the command-line parameter and the value.  If
  6330.             the value must  include spaces, you  must replace them  with
  6331.             the underscore character. So if you use the /M  command-line
  6332.             option to move files to C:\ZIP, you must supply /MC:\ZIP;
  6333.  
  6334.  The following command-line options are available and can be used:
  6335.  
  6336.  4.1.1 Command-line parameters that stand on their own
  6337.  ───────────────────────────────────────────────────────────────────────
  6338.  The following command-line  parameters can be  used (in special  cases)
  6339.  and they don't have any counterpart in MTA.CTL.
  6340.  
  6341.  
  6342.  ┌─────────────────────────────────────────────────────────────────────┐
  6343.  │ /?                                                                  │
  6344.  └─────────────────────────────────────────────────────────────────────┘
  6345.  Function : Using /? will  activate MTA's help system. When  this system
  6346.             is invoked, no conversion will be possible. You are shown  a
  6347.             screen where  all command-line  options are  described.  You
  6348.             can now hit the [ENTER] key and you will have the option  to
  6349.             setup the  calling sequence  for MTA.  You can  do this  for
  6350.             different options until  you have all  the options you  need
  6351.             (so you can read about  the option and its syntax  while you
  6352.             can write  it down  in the  help-screen's little note-book).
  6353.             When you have finished (use  [ESC]), the system will make  a
  6354.             batch-file, called GOMTA.BAT  with all this  options inside.
  6355.             You can  start this  batch-file (and  you can  even add some
  6356.             extra parameters to it);
  6357.  
  6358.  ┌─────────────────────────────────────────────────────────────────────┐
  6359.  │ /CTL[path]                                                          │
  6360.  │ /CTL[file]                                                          │
  6361.  └─────────────────────────────────────────────────────────────────────┘
  6362.  Function : By default,  MTA will use MTA.CTL  IF the file is  somewhere
  6363.             in  the  DOS  path  (DOS  2.x  and  higher),  in the current
  6364.             directory (all DOS versions)  or in the directory  where the
  6365.             MTA.EXE file resides (DOS  3.x and higher). If  your MTA.CTL
  6366.             does not  follow this  conventions OR  you want  to assign a
  6367.             different name for it OR  you want to use an  alternate file
  6368.             for special tasks, you can instruct MTA to use this file  if
  6369.             you supply the /CTL command-line parameter. It comes in  two
  6370.             forms. Either  you supply  a complete  path (eg.  the drive,
  6371.             directory and filename, or you just supply the filename,  if
  6372.             MTA is able to  find it in the  same was as it  can find the
  6373.             MTA.CTL (path, current directory, executed directory).
  6374.  
  6375.  ┌─────────────────────────────────────────────────────────────────────┐
  6376.  │ /TASKnn                                                             │
  6377.  └─────────────────────────────────────────────────────────────────────┘
  6378.  Function : If you  want to run multiple  (concurrent) runs of MTA,  you
  6379.             must  supply  a  task-number  to  each  of  the concurrently
  6380.             running  tasks.  By  default,  MTA  assumes that is will run
  6381.             stand alone. If  this is not  the case, you  must supply the
  6382.             /TASK switch  with a  task-number from  01 to  99. Each con-
  6383.             currently running MTA must have a different task-number !
  6384.  
  6385.  ┌─────────────────────────────────────────────────────────────────────┐
  6386.  │ /LVL0                                                               │
  6387.  │ /LVL1                                                               │
  6388.  │ /LVL2                                                               │
  6389.  │ /LVL3                                                               │
  6390.  └─────────────────────────────────────────────────────────────────────┘
  6391.  Function : There are several  command-line parameters that can be  used
  6392.             to  limit  (extend)  the  search  for files to be converted.
  6393.             The set  of /LVLx  command-line parameters  can be  used (in
  6394.             combination with  the filemask(s))  to define  WHERE MTA has
  6395.             to look for files. They  can be used as command-line  driven
  6396.             replacement for some of the options in MTA.CTL  (DefaultPath
  6397.             to name one). The search is extended in the following way:
  6398.  
  6399.             /LVL0 : The  search will be  done in the  CURRENT directory.
  6400.                     This is the  same as NOT  using any DefaultPath  (or
  6401.                     alike) option in  MTA.CTL or using  /W when you  did
  6402.                     set these options.  It can be  overruled to run  MTA
  6403.                     from  the   command-line  for   just  the    current
  6404.                     directory without having  to change the  DefaultPath
  6405.                     (or alike) options in MTA.CTL;
  6406.  
  6407.             /LVL1 : With /LVL1,  MTA will  look in  all  sub-directories
  6408.                     under (NOT INCLUDING) the current directory;
  6409.  
  6410.             /LVL2 : With /LVL2,  MTA will  look in  all  sub-directories
  6411.                     under AND the current directory;
  6412.  
  6413.             /LVL3 : With /LVL3, MTA will search the whole CURRENT  drive
  6414.                     (all directories included);
  6415.  
  6416.  ┌─────────────────────────────────────────────────────────────────────┐
  6417.  │ /@[path]                                                            │
  6418.  └─────────────────────────────────────────────────────────────────────┘
  6419.  Function  :  All  the  files  you  want  to  convert can be selected in
  6420.             several ways.  The usage  of the  /@ command-line  option is
  6421.             just  only  one  of  them.  [path]  must  point  to a drive,
  6422.             directory  and  filename  that  exists.  This file must be a
  6423.             ASCII flat-file  (created with  any normal  line-editor) and
  6424.             it must contain  one filename on  each line (any  drives and
  6425.             directories are stripped by MTA internally). All files  must
  6426.             reside  in  one  directory.  It  is allowed to use wildcards
  6427.             but, unlike the  masks you can  supply on the  command-line,
  6428.             the extension '.*' is NOT  added when you do not  supply any
  6429.             extension.   MTA  will  convert  all  these  files  (if they
  6430.             exist) after each  other. You can  use /@ when  the masks on
  6431.             the normal command-line would  exceed the maximum number  of
  6432.             bytes of a parameter list;
  6433.  
  6434.  ┌─────────────────────────────────────────────────────────────────────┐
  6435.  │ /IP[password]                                                       │
  6436.  └─────────────────────────────────────────────────────────────────────┘
  6437.  Function : With  MTA you can  convert encrypted files.  When you select
  6438.             such files, you MUST  supply the original password  that was
  6439.             used for encryption.  You can only  supply ONE password  for
  6440.             each  execution  of  MTA,  so  when you must convert various
  6441.             files with  various passwords,  you must  do so  in separate
  6442.             runs of MTA. The password that is needed for the  decompress
  6443.             of the input-file,  is supplied with  the /IP option.  There
  6444.             is (obvious) no counterpart in MTA.CTL;
  6445.  
  6446.  ┌─────────────────────────────────────────────────────────────────────┐
  6447.  │ /OP[password]                                                       │
  6448.  │ /OP@                                                                │
  6449.  └─────────────────────────────────────────────────────────────────────┘
  6450.  Function : It is possible to  let MTA create new archives that  will be
  6451.             encrypted with  a password.  In this  case, you  must supply
  6452.             the password  for the  target files,  which is  used as  the
  6453.             password for compression IF  the target system supports  any
  6454.             encryption in this way. Any target files with passwords  are
  6455.             (optionally)  recorded  in  a  log-file  (filename  and  the
  6456.             password). There is no counterpart in MTA.CTL BUT you  could
  6457.             use the xxxCompression options  to set a fixed  password (if
  6458.             needed).
  6459.  
  6460.             When you  use /OP  with a  password, you  can also  use some
  6461.             macros  inside  [password],  in  which  case  MTA  will do a
  6462.             substitution  of  the  macros.  The  following  macros   are
  6463.             available:
  6464.  
  6465.             $JD : Replaced by julian-date number. This is the number  of
  6466.                   days, counted from the  start of the year,  so January
  6467.                   31th  will  be  date-number  31,  February 2nd will be
  6468.                   number 33 and so on;
  6469.  
  6470.             $JY : Replaced by the  year-component. These are the last  2
  6471.                   bytes of the year (so 92 for 1992);
  6472.  
  6473.             $ND : The current day   (2 positions always);
  6474.  
  6475.             $NM : The current month (2 positions always);
  6476.  
  6477.             $NY : The current year  (4 positions always);
  6478.  
  6479.             $FN : The current filename (only name, not extension)
  6480.  
  6481.             /OP$JY$JDRvh will  create a  password of  92002Rvh when used
  6482.             on January  2nd 1992.  With this  macros you  can create any
  6483.             password you like, as long  as the target password (and  the
  6484.             supplied [password]) will NOT contain any spaces.
  6485.  
  6486.             /OP@ is a special form  of password usage for output  files.
  6487.             If you supply /OP@, MTA will generate a RANDOM password  for
  6488.             every file it  converts. In this  case the logging  of these
  6489.             passwords is mandatory otherwise you would never know  which
  6490.             passwords were assigned to which files. These IS some  usage
  6491.             for this option.  You can allow  users to download  ANYTHING
  6492.             from your system but they  can only use the files  when they
  6493.             obtain the  password in  another way  (by calling  you on  a
  6494.             separate line, by paying you in which case you can send  the
  6495.             passwords by mail etc.);
  6496.  
  6497.  ┌─────────────────────────────────────────────────────────────────────┐
  6498.  │ /ALT                                                                │
  6499.  └─────────────────────────────────────────────────────────────────────┘
  6500.  Function : When you  have set  SPECIAL versions  of archivers (see  the
  6501.             xxxPath and xxxVersion options in MTA.CTL) that can be  used
  6502.             (on  request)  for  testing  or  swift  conversion,  you can
  6503.             select THESE  versions (which  are not  the normal versions)
  6504.             by  using  the  /ALT  command-line  parameter.  When /ALT is
  6505.             used, MTA will look if an alternate version of any  archiver
  6506.             is set and will, if set, this version (if needed). If  there
  6507.             is  no  special  version  set,  /ALT  will  cause the normal
  6508.             version to be  used. See the  chapter on using  new versions
  6509.             of archivers;
  6510.  
  6511.  ┌─────────────────────────────────────────────────────────────────────┐
  6512.  │ /SIM                                                                │
  6513.  └─────────────────────────────────────────────────────────────────────┘
  6514.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6515.             simulate mode. For  each archive to  be converted, MTA  will
  6516.             do the following:
  6517.  
  6518.             - Decompress the file;
  6519.             - Scan for Virus;
  6520.             - Call exits;
  6521.  
  6522.             This option  comes in  handy when  you execute  MTA under  a
  6523.             door inside  a BBS  (FileDoor) to  look for  a virus  inside
  6524.             files,  the  moment  the  file  is  uploaded or to check you
  6525.             files  (without  a  convert)  when  a  new  virus-scanner is
  6526.             released.   There   is  no  counterpart   option  for   this
  6527.             command-line parameter in the MTA.CTL file;
  6528.  
  6529.  ┌─────────────────────────────────────────────────────────────────────┐
  6530.  │ /REMSIM                                                             │
  6531.  └─────────────────────────────────────────────────────────────────────┘
  6532.  Function : This option can be used to create a file called MTAVANSI.xxx
  6533.             (where xxx is equal  to the MTA-task number, by default this
  6534.             will be 001). After MTA  has  finished, you can use DOS TYPE
  6535.             to list the file. You  will see what otherwise a remote call
  6536.             would have seen when  MTA  would  have been used under a BBS
  6537.             door (like  FileDoor  <tm>). You  can  use several runs with
  6538.             /REMSIM to adjust  the  remote  colors  to  your own taste !
  6539.  
  6540.             If you do not delete the  MTAVANSI.xxx  file  yourself,  MTA
  6541.             will append to that  file  if  /REMSIM is used again and the
  6542.             file is still in place (by  default, MTA will place the file
  6543.             in the CURRENT directory).
  6544.  
  6545.  
  6546.  ┌─────────────────────────────────────────────────────────────────────┐
  6547.  │ /DATE                                                               │
  6548.  └─────────────────────────────────────────────────────────────────────┘
  6549.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  6550.             simulate mode. For  each archive to  be converted, MTA  will
  6551.             do the following:
  6552.  
  6553.            - Test if the file matches any mask;
  6554.  
  6555.            - If it does,  test if the date  is lower than the  date that
  6556.              you supplied in the DelOldFiles option;
  6557.  
  6558.            - If it  does, manipulate the  file (delete, move)  depending
  6559.              on the DelOldPath option;
  6560.  
  6561.            This option  comes in  handy when  you execute  MTA to remove
  6562.            (without  conversion)  all  your  files  that  are too old to
  6563.            keep.
  6564.  
  6565.  ┌─────────────────────────────────────────────────────────────────────┐
  6566.  │ /ANS[type]                                                          │
  6567.  └─────────────────────────────────────────────────────────────────────┘
  6568.  Function : When this  command-line parameter  is NOT  set AND MTA  will
  6569.             use remote  logging, MTA  will use  ANSI sequences.  This is
  6570.             also  the  case  when  you  code  any  value from 1 to 9 for
  6571.             [type].  If  you  use  the  value  0 for [type] MTA will use
  6572.             ASCII for remote logging;
  6573.  
  6574.  ┌─────────────────────────────────────────────────────────────────────┐
  6575.  │ /D{=d:}                                                             │
  6576.  └─────────────────────────────────────────────────────────────────────┘
  6577.  Function : With this parameter  you instruct MTA to start  the diskette
  6578.             support as described before. There is no alternative  option
  6579.             for  it  in  MTA.CTL.   When  you  use  /D,  MTA  will start
  6580.             diskette  support  for  DRIVE  A:.   If  your  diskettes are
  6581.             accessed from another  drive (eg.   B:), you must  use /D=B:
  6582.             to do so;
  6583.  
  6584.  
  6585.  4.1.2 Command-line parameters that overrule/toggle/disable MTA.CTL
  6586.  ───────────────────────────────────────────────────────────────────────
  6587.  The following command-line parameters  will either switch an  option in
  6588.  MTA.CTL on, off  or will act  like a toggle.  Some can overrule  values
  6589.  that are set in MTA.CTL.
  6590.  
  6591.  
  6592.  ┌─────────────────────────────────────────────────────────────────────┐
  6593.  │ /ARC                                                                │
  6594.  │ /ARJ                                                                │
  6595.  │ /ARJSFX                                                             │
  6596.  │ /DWC                                                                │
  6597.  │ /HYP                                                                │
  6598.  │ /LZH                                                                │
  6599.  │ /LZHSFX                                                             │
  6600.  │ /LZS                                                                │
  6601.  │ /MD                                                                 │
  6602.  │ /OWN                                                                │
  6603.  │ /PAK                                                                │
  6604.  │ /PAKSFX                                                             │
  6605.  │ /SQZ                                                                │
  6606.  │ /SQZSFX                                                             │
  6607.  │ /ZIP                                                                │
  6608.  │ /ZIPSFX                                                             │
  6609.  │ /ZOO                                                                │
  6610.  │ /PKLITE                                                             │
  6611.  │ /UNPKLITE                                                           │
  6612.  │ /GIFLITE                                                            │
  6613.  │ /GIF2JPG                                                            │
  6614.  │ /JPG2GIF                                                            │
  6615.  │ /GIF                                                                │
  6616.  └─────────────────────────────────────────────────────────────────────┘
  6617.  Function : Normally MTA will  convert all matched (and selected)  files
  6618.             to the system you assigned to the CompressionType option  in
  6619.             MTA.CTL. With these  command-line switches you  can overrule
  6620.             them with another format  (see CompressionType option for  a
  6621.             description of the various supported targets);
  6622.  
  6623.  ┌─────────────────────────────────────────────────────────────────────┐
  6624.  │ /NO4DOS                                                             │
  6625.  └─────────────────────────────────────────────────────────────────────┘
  6626.  Function : When you  run under  4DOS <tm>  and you  want to  use  MTA's
  6627.             internal move  options, you   can overrule  the 4DOS    <tm>
  6628.             MOVE command   with   this   parameter.   It   has the  same
  6629.             meaning  as  when  you  include  the  Not4DOSAware option in
  6630.             MTA.CTL.
  6631.  
  6632.  ┌─────────────────────────────────────────────────────────────────────┐
  6633.  │ /W{directory}                                                       │
  6634.  └─────────────────────────────────────────────────────────────────────┘
  6635.  Function : When you  have included  DefaultPath (or  alike) options  in
  6636.             MTA.CTL, or you wish  to convert files in  another directory
  6637.             as the current, you can include /W. /W by itself will  over-
  6638.             rule  any  DefaultPath  (or  alike,  like RAPaths) option in
  6639.             MTA.CTL  and  will  force  MTA  to  work  inside the CURRENT
  6640.             directory. /W{directory}  (so you  append a  valid directory
  6641.             to the parameter, like /WD:\ZIP)  will force MTA to work  on
  6642.             the supplied directory;
  6643.  
  6644.  ┌─────────────────────────────────────────────────────────────────────┐
  6645.  │ /TOUCHC{+days}                                                      │
  6646.  │ /TOUCHH                                                             │
  6647.  │ /TOUCHL                                                             │
  6648.  │ /TOUCHF                                                             │
  6649.  └─────────────────────────────────────────────────────────────────────┘
  6650.  Function : One of  these command-line  parameters can  be used (if  you
  6651.             use multiple at the same time, only the last will count)  to
  6652.             overrule the touching system that MTA uses. If you have  set
  6653.             a  way  of  touching  (TouchHig,  TouchCur, TouchLow) in the
  6654.             MTA.CTL,  these  parameters  can  be  used  to overrule this
  6655.             option in the following way:
  6656.  
  6657.             /TOUCHC : Converted  files  will  get the current date (or a
  6658.                       date {+days} (for example /TOUCHC+10 for +10 days)
  6659.                       away from the current-date;
  6660.  
  6661.             /TOUCHH  : The  same  as  using TouchHig in MTA.CTL (use the
  6662.                        highest date inside the archive);
  6663.  
  6664.             /TOUCHL : The  same as using TouchLow in in MTA.CTL (use the
  6665.                       lowest date inside the archive);
  6666.  
  6667.             /TOUCHF :  Files will keep the same date as they  had before
  6668.                        the conversion started;
  6669.  
  6670.  ┌─────────────────────────────────────────────────────────────────────┐
  6671.  │ /M{directory}                                                       │
  6672.  └─────────────────────────────────────────────────────────────────────┘
  6673.  Function : If you  use the MoveToDir option  in MTA.CTL you can  use /M
  6674.             on its own to make that option inactive. If you also  append
  6675.             a directory (eg. /MD:\ZIP\TRA), it will work the same as  if
  6676.             you supplied  D:\ZIP\TRA as  the directory  in this  option.
  6677.             So  /MD:\ZIP\TRA  will  move  converted  files to D:\ZIP\TRA
  6678.             even when the MoveToDir  option in MTA.CTL is  set otherwise
  6679.             or when it is not set at all;
  6680.  
  6681.  ┌─────────────────────────────────────────────────────────────────────┐
  6682.  │ /C2G[options]                                                       │
  6683.  │ /C2J[options]                                                       │
  6684.  │ /CD[options]                                                        │
  6685.  │ /CGL[options]                                                       │
  6686.  │ /CH[options]                                                        │
  6687.  │ /CHS[options]                                                       │
  6688.  │ /CJ[options]                                                        │
  6689.  │ /CJS[options]                                                       │
  6690.  │ /CL[options]                                                        │
  6691.  │ /CQ[options]                                                        │
  6692.  │ /CS[options]                                                        │
  6693.  │ /CSS[options]                                                       │
  6694.  │ /CZ[options]                                                        │
  6695.  │ /CZS[options]                                                       │
  6696.  │ /CGT[options]                                                       │
  6697.  └─────────────────────────────────────────────────────────────────────┘
  6698.  Function : For  almost all archivers  (and GIF-alike programs)  you can
  6699.             add some extra options for  each and every archiver (or  GIF
  6700.             program).  These  options  can  be  found  in MTA.CTL as the
  6701.             xxxCompression options (see over there). You can also  over-
  6702.             rule them (or add them  on the fly) with these  command-line
  6703.             parameters. [options]  must be  the added  options for  that
  6704.             archiver. Spaces must be replaced by underscore  characters,
  6705.             so '-a -z'  must be coded  as '-a_-z' (without  the quotes).
  6706.             Each of the command-line parameter stands for:
  6707.  
  6708.             - /C2G        GIF2JPG
  6709.             - /C2J        JPG2GIF
  6710.             - /CD         DWC
  6711.             - /CGL        GIFLITE
  6712.             - /CH         LZH
  6713.             - /CHS        LZH (SFX)
  6714.             - /CJ         ARJ
  6715.             - /CJS        ARJ (SFX)
  6716.             - /CL         PKLITE
  6717.             - /CQ         ZOO
  6718.             - /CS         SQZ
  6719.             - /CSS        SQZ (SFX)
  6720.             - /CZ         ZIP
  6721.             - /CZS        ZIP2EXE (ZIP SFX)
  6722.             - /CGT        GIFTEST
  6723.  
  6724.             Refer to the documentation for  each archiver to see a  list
  6725.             of non-common options that  can be used. Also  remember that
  6726.             the SFX creation is done  AFTER the compression (and NOT  at
  6727.             the  same  time,  even  if  the compression program supports
  6728.             it).   This means  that adding  something for  LZH SFX  will
  6729.             cause that it will  ONLY be used to  create the SFX and  NOT
  6730.             for  the  compression  of  the  LZH-file  (same goes for all
  6731.             other SFX's);
  6732.  
  6733.  ┌─────────────────────────────────────────────────────────────────────┐
  6734.  │ /Z{path}                                                            │
  6735.  └─────────────────────────────────────────────────────────────────────┘
  6736.  Function :  This command-line  parameter has  the same  meaning as  the
  6737.             usage of  the AutoDescription  option in  MTA.CTL. When  you
  6738.             use /Z as is, the AutoDescription option (if set) is  turned
  6739.             off and no  comments will be  added. When you  append a path
  6740.             (the drive,  directory and  filename) to  the parameter, the
  6741.             file  that  you  supply  will  be  added  as  comment to all
  6742.             converted archives that support  these comments. As such  it
  6743.             can be  used to  (temporary) add  the AutoDescription  or to
  6744.             overrule the values set in MTA.CTL;
  6745.  
  6746.  ┌─────────────────────────────────────────────────────────────────────┐
  6747.  │ /CARCOM{n}                                                          │
  6748.  └─────────────────────────────────────────────────────────────────────┘
  6749.  Function : This command-line option can be used to change the  behavior
  6750.             of the CarryComment  option in MTA.CTL  (if set).   When you
  6751.             supply /CARCOM  as is,  the CarryComment  option in  MTA.CTL
  6752.             will  be  (temporary)  switched  off.  If  you  use /CARCOMn
  6753.             (where 'n' is  the number 1,  2 or 3),  you can (re)set  the
  6754.             function of the CarryComment option for this run;
  6755.  
  6756.  ┌─────────────────────────────────────────────────────────────────────┐
  6757.  │ /AFB                                                                │
  6758.  │ /AFB- or /AFB+                                                      │
  6759.  └─────────────────────────────────────────────────────────────────────┘
  6760.  Function : This command-line parameter is a toggle for the  AddFilesBBS
  6761.             option in MTA.CTL;
  6762.  
  6763.  ┌─────────────────────────────────────────────────────────────────────┐
  6764.  │ /P                                                                  │
  6765.  └─────────────────────────────────────────────────────────────────────┘
  6766.  Function : When  you use the  /P command-line parameter,  MTA will stop
  6767.             any logging in  the normal log-file(s)  for the duration  of
  6768.             the run.
  6769.  
  6770.  ┌─────────────────────────────────────────────────────────────────────┐
  6771.  │ /DI                                                                 │
  6772.  │ /DE                                                                 │
  6773.  │ /DD                                                                 │
  6774.  └─────────────────────────────────────────────────────────────────────┘
  6775.  Function :  You can  disable the  functions of  the options IncludeFile
  6776.             (/DI), ExcludeFile  (/DE) and  the DoNot  (/DD) options with
  6777.             help of these command-line parameters;
  6778.  
  6779.  ┌─────────────────────────────────────────────────────────────────────┐
  6780.  │ /E1                                                                 │
  6781.  │ /E2                                                                 │
  6782.  │ /EB                                                                 │
  6783.  │ /EG                                                                 │
  6784.  └─────────────────────────────────────────────────────────────────────┘
  6785.  Functions : Any  exit  you   have  declared, can be disabled. /E1  will
  6786.              disable ExitBeforeFill (if set),  /E2 will do the  same for
  6787.              ExitAfterFill (if set),  /EB for ExitBetweenConversion  and
  6788.              /EG for  ExitAfterCompression. Exits  can only  be SET with
  6789.              help of options in MTA.CTL;
  6790.  
  6791.  ┌─────────────────────────────────────────────────────────────────────┐
  6792.  │ /U                                                                  │
  6793.  │ /U[filename]                                                        │
  6794.  │ /U[path]                                                            │
  6795.  └─────────────────────────────────────────────────────────────────────┘
  6796.  Function : This  command-line   parameter  comes in three flavors.  The
  6797.             first, /U, is a toggle  for the FilesBBS option in  MTA.CTL.
  6798.             /U will  disable the  option if  it was  set in  MTA.CTL and
  6799.             will enable the option if it was not set.
  6800.  
  6801.             /U[filename] will  enable the  FilesBBS option  but in  this
  6802.             case you  overrule the  filename FILES.BBS  (in the  working
  6803.             directory) with [filename].
  6804.  
  6805.             /U[path] will enable  the FilesBBS option  but in this  case
  6806.             you overrule the filename  FILES.BBS AND the fact  that this
  6807.             file  must  reside  in  EACH  working directory with [path].
  6808.             [path] is  the SINGLE  filename (with  drive and  directory)
  6809.             that MTA will update (RBBS master directory and such);
  6810.  
  6811.  ┌─────────────────────────────────────────────────────────────────────┐
  6812.  │ /NOOLD                                                              │
  6813.  └─────────────────────────────────────────────────────────────────────┘
  6814.  Function : When  you added the  DelOldFiles option to  MTA.CTL, you can
  6815.             use /NOOLD to switch the option off.
  6816.  
  6817.  ┌─────────────────────────────────────────────────────────────────────┐
  6818.  │ /UPGRADE                                                            │
  6819.  │ /UPGRADE+ or /UPGRADE-                                              │
  6820.  └─────────────────────────────────────────────────────────────────────┘
  6821.  Function : This command-line parameter is a toggle for the  OnlyUpgrade
  6822.             option in MTA.CTL;
  6823.  
  6824.  ┌─────────────────────────────────────────────────────────────────────┐
  6825.  │ /SBA                                                                │
  6826.  │ /SBA+ or /SBA-                                                      │
  6827.  └─────────────────────────────────────────────────────────────────────┘
  6828.  Function : This command-line parameter is a toggle for the  SkipBackups
  6829.             option in MTA.CTL;
  6830.  
  6831. │┌─────────────────────────────────────────────────────────────────────┐
  6832. ││ /NFC or /NFC-                                                       │
  6833. │└─────────────────────────────────────────────────────────────────────┘
  6834. │Function : This command-line  parameter  toggles   the  FIXEDCONVERSION
  6835. │           option in MTA.CTL  to  off. You  can  not toggle this option
  6836. │           to ON. When FIXEDCONVERSION options are set in MTA.CTL, they
  6837. │           are set ON by default.
  6838. │
  6839. │┌─────────────────────────────────────────────────────────────────────┐
  6840. ││ /NUU or /NUU-                                                       │
  6841. │└─────────────────────────────────────────────────────────────────────┘
  6842. │Function : This command-line parameter  toggles  the UPDATEUNTYPEDFILES
  6843. │           option to off (on is not possible);
  6844. │
  6845. │┌─────────────────────────────────────────────────────────────────────┐
  6846. ││ /NUM or /NUM-                                                       │
  6847. │└─────────────────────────────────────────────────────────────────────┘
  6848. │Function : This  command-line  parameter   toggles  the  UPDATEMSGFILES
  6849. │           option to off (on is not possible);
  6850. │
  6851. │┌─────────────────────────────────────────────────────────────────────┐
  6852. ││ /NUT or /NUT-                                                       │
  6853. │└─────────────────────────────────────────────────────────────────────┘
  6854. │Function : This  command-line  parameter  toggles  the  UPDATETICKFILES
  6855. │           option to off (on is not possible);
  6856. │
  6857. │┌─────────────────────────────────────────────────────────────────────┐
  6858. ││ /NUF or /NUF-                                                       │
  6859. │└─────────────────────────────────────────────────────────────────────┘
  6860. │Function : This  command-line  parameter   toggles  the  UPDATEFESFILES
  6861. │           option to off (on is not possible);
  6862. │
  6863. │┌─────────────────────────────────────────────────────────────────────┐
  6864. ││ /NMA or /NMA-                                                       │
  6865. │└─────────────────────────────────────────────────────────────────────┘
  6866. │Function : This  command-line  parameter toggles the  MAKEARC option to
  6867. │           off (on is not possible);
  6868. │
  6869. │┌─────────────────────────────────────────────────────────────────────┐
  6870. ││ /NME or /NME-                                                       │
  6871. │└─────────────────────────────────────────────────────────────────────┘
  6872. │Function : This  command-line  parameter   toggles  the  MAKEARCEXCLUDE
  6873. │           option to off (on is not possible);
  6874.  
  6875.  ┌─────────────────────────────────────────────────────────────────────┐
  6876.  │ /NOB                                                                │
  6877.  │ /NOB+ or /NOB-                                                      │
  6878.  └─────────────────────────────────────────────────────────────────────┘
  6879.  Function : This  command-line  parameter   is  a toggle for the  NoBeep
  6880.             option in MTA.CTL;
  6881.  
  6882.  ┌─────────────────────────────────────────────────────────────────────┐
  6883.  │ /NVI                                                                │
  6884.  └─────────────────────────────────────────────────────────────────────┘
  6885.  Function : This command-line parameter  will  switch of  the configured
  6886.             virus scanners for the duration of this run.
  6887.  
  6888.  ┌─────────────────────────────────────────────────────────────────────┐
  6889.  │ /NVM                                                                │
  6890.  └─────────────────────────────────────────────────────────────────────┘
  6891.  Function : This command-line parameter  will  switch of  the configured
  6892.             masks that  limit  the scan for a virus. If /NVM is supplied
  6893.             and the VirusScanner  options  are  available and active (no
  6894.             usage of /NVI), the scan  is ALWAYS  performed on EVERY file
  6895.             in EVERY archive.
  6896.  
  6897.  ┌─────────────────────────────────────────────────────────────────────┐
  6898.  │ /NOEMS                                                              │
  6899.  │ /NOXMS                                                              │
  6900.  └─────────────────────────────────────────────────────────────────────┘
  6901.  Function : This command-line  parameters can  be used  to disable   the
  6902.             usage of EMS  and/or XMS. The  same can be  done permanently
  6903.             with the NoEMS and/or NoXMS options in MTA.CTL;
  6904.  
  6905.  ┌─────────────────────────────────────────────────────────────────────┐
  6906.  │ /VMODE{mode}                                                        │
  6907.  └─────────────────────────────────────────────────────────────────────┘
  6908.  Function : /VMODE  as is, will  switch any VideoMode  option in MTA.CTL
  6909.             to OFF.  /VMode{mode} (where  {mode} is  the DECIMAL  video-
  6910.             mode) will force MTA to switch the video-card to {mode};
  6911.  
  6912.  ┌─────────────────────────────────────────────────────────────────────┐
  6913.  │ /EXTTST                                                             │
  6914.  │ /EXTTST+ or /EXTTST-                                                │
  6915.  └─────────────────────────────────────────────────────────────────────┘
  6916.  Function : /EXTTST is used  as a toggle for the  ExtendedTesting option
  6917.             in MTA.CTL.
  6918.  
  6919.  ┌─────────────────────────────────────────────────────────────────────┐
  6920.  │ /SFX                                                                │
  6921.  │ /SFX+ or /SFX-                                                      │
  6922.  └─────────────────────────────────────────────────────────────────────┘
  6923.  Function : /SFX  is  used  as  a  toggle  for  the SFXFiles option in
  6924.             MTA.CTL;
  6925.  
  6926.  ┌─────────────────────────────────────────────────────────────────────┐
  6927.  │ /LEA                                                                │
  6928.  │ /LEA+ or /LEA-                                                      │
  6929.  └─────────────────────────────────────────────────────────────────────┘
  6930.  Function : /LEA is  used as  a toggle  for the  KeepAbnormalExtensions
  6931.             option in MTA.CTL;
  6932.  
  6933.  ┌─────────────────────────────────────────────────────────────────────┐
  6934.  │ /TIM                                                                │
  6935.  └─────────────────────────────────────────────────────────────────────┘
  6936.  Function : When  you use the  /TIM command-line parameter,  you disable
  6937.             the RunTime option in MTA.CTL (if set);
  6938.  
  6939.  ┌─────────────────────────────────────────────────────────────────────┐
  6940.  │ /NEW                                                                │
  6941.  │ /NEW+ or /NEW-                                                      │
  6942.  └─────────────────────────────────────────────────────────────────────┘
  6943.  Function : /NEW is  used as  a toggle  for the  OnlyNewFiles option in
  6944.             MTA.CTL;
  6945.  
  6946.  ┌─────────────────────────────────────────────────────────────────────┐
  6947.  │ /MAR                                                                │
  6948.  │ /MAR+ or /MAR-                                                      │
  6949.  └─────────────────────────────────────────────────────────────────────┘
  6950.  Function : /MAR  is  used  as   a  toggle  for  the NoMarked option  in
  6951.             MTA.CTL;
  6952.  
  6953.  ┌─────────────────────────────────────────────────────────────────────┐
  6954.  │ /MAH{string}                                                        │
  6955.  └─────────────────────────────────────────────────────────────────────┘
  6956.  Function : If you want to  change the value for the MarkHeader  option,
  6957.             you can use the  /MAH{string} command-line option. When  you
  6958.             do  not  supply  {string},  MTA  will  be  forced to use the
  6959.             default value. When used, {string} must be 6 bytes of less;
  6960.  
  6961.  ┌─────────────────────────────────────────────────────────────────────┐
  6962.  │ /MAS{string}                                                        │
  6963.  └─────────────────────────────────────────────────────────────────────┘
  6964.  Function : If you want to  change the value for the MarkString  option,
  6965.             you can use the  /MAS{string} command-line option. When  you
  6966.             do  not  supply  {string},  MTA  will  be  forced to use the
  6967.             default  value.  When  used,  {string}  must  be 14 bytes of
  6968.             less;
  6969.  
  6970.  ┌─────────────────────────────────────────────────────────────────────┐
  6971.  │ /UNMARK                                                             │
  6972.  │ /UNMARK+ or /UNMARK-                                                │
  6973.  └─────────────────────────────────────────────────────────────────────┘
  6974.  Function : /UNMARK  is  used  as   a  toggle  for the UnMark option  in
  6975.             MTA.CTL;
  6976.  
  6977. │┌─────────────────────────────────────────────────────────────────────┐
  6978. ││ /NOOWNMARK                                                          │
  6979. │└─────────────────────────────────────────────────────────────────────┘
  6980. │Function : /NOOWNMARK should only be used when MTA is executed under a
  6981. │           protocol  driver like FIleDoor <tm> (XFD). In this case, the
  6982. │           incomming (uploaded) files are checked against your own mark
  6983. │           that you  use with NoMarked/MarkString. If the file contains
  6984. │           the same mark, MTA will delete the file at once. This option
  6985. │           will stop  those  users who download a file from you, rename
  6986. │           the file to a bogus-name and upload it again. The dupe-check
  6987. │           will not deny such a file, but MTA can see that it is one of
  6988. │           your own files. If  you  use  /NOOWNMARK  you should make it
  6989. │           sure that you are NOT using the DEFAULT  mark-string but one
  6990. │           of your own !!
  6991.  
  6992.  ┌─────────────────────────────────────────────────────────────────────┐
  6993.  │ /OOA                                                                │
  6994.  │ /OOA+ or /OOA-                                                      │
  6995.  └─────────────────────────────────────────────────────────────────────┘
  6996.  Function : Using /OOA  will do  the same  as using  the  OptimizeOnSize
  6997.             option in MTA.CTL;
  6998.  
  6999.  ┌─────────────────────────────────────────────────────────────────────┐
  7000.  │ /AIA                                                                │
  7001.  │ /AIA+ or /AIA-                                                      │
  7002.  └─────────────────────────────────────────────────────────────────────┘
  7003.  Function : /AIA  is  used   as  a  toggle for the NoArcInArc  option in
  7004.             MTA.CTL;
  7005.  
  7006.  ┌─────────────────────────────────────────────────────────────────────┐
  7007.  │ /KEEPAV                                                             │
  7008.  │ /KEEPAV+ or /KEEPAV-                                                │
  7009.  └─────────────────────────────────────────────────────────────────────┘
  7010.  Function : /KEEPAV  is  used  as   a  toggle  for the KeepAV option  in
  7011.             MTA.CTL;
  7012.  
  7013.  ┌─────────────────────────────────────────────────────────────────────┐
  7014.  │ /KEEPVL                                                             │
  7015.  │ /KEEPVL+ or /KEEPVL-                                                │
  7016.  └─────────────────────────────────────────────────────────────────────┘
  7017.  Function : /KEEPVL  is  used  as   a  toggle  for the KeepVL option  in
  7018.             MTA.CTL;
  7019.  
  7020.  ┌─────────────────────────────────────────────────────────────────────┐
  7021.  │ /ALL                                                                │
  7022.  │ /ALL+ or /ALL-                                                      │
  7023.  └─────────────────────────────────────────────────────────────────────┘
  7024.  Function : /ALL is used as a toggle for the AllDisketteFiles option  in
  7025.             MTA.CTL;
  7026.  
  7027.  ┌─────────────────────────────────────────────────────────────────────┐
  7028.  │ /BAUD[baudrate]                                                     │
  7029.  │ /COM[comport]                                                       │
  7030.  │ /FOSSIL[fossilport]                                                 │
  7031.  │ /REMOTE                                                             │
  7032.  └─────────────────────────────────────────────────────────────────────┘
  7033.  Function : When MTA is used under a door inside a BBS and you want  MTA
  7034.             to keep the user informed about the current status, you  can
  7035.             use /BAUD, /COM (or /PORT) and /REMOTE (or their  equivalent
  7036.             counterparts in  MTA.CTL) to  do so.  [baudrate] can  be the
  7037.             baudrate  (locked  or  not)  or  0  (in which case NO remote
  7038.             operations will be done). [comport] can be a valid COM  port
  7039.             or 0 (in which case  no remote operations will take  place).
  7040.             [fossilport]  must  be  the  valid  fossil-port, there is no
  7041.             value to  switch remote  operations off  other than  setting
  7042.             [baudrate] to 0.  /COM is preferred.  You can use  all these
  7043.             command-line parameters (or  their counterparts in  MTA.CTL)
  7044.             but they  will do  nothing unless  the following combination
  7045.             is  made  (where  the  command-line  parameters overrule any
  7046.             options in MTA.CTL):
  7047.  
  7048.             - /BAUD (Baudrate) must be set to a non-zero value;
  7049.             - /COM  (ComPort )  ,,  ,,  ,, ,,    ,,  ,,    ,,  OR
  7050.               /FOSSIL (FossilPort) must be used;
  7051.             - /REMOTE (Remote) is used;
  7052.  
  7053.             You should  also look  into the  /ANS command-line parameter
  7054.             in the previous (sub)chapter.
  7055.  
  7056.  ┌─────────────────────────────────────────────────────────────────────┐
  7057.  │ /STOSIZ{ext}                                                        │
  7058.  └─────────────────────────────────────────────────────────────────────┘
  7059.  Function : /STOSIZ  is  used   as  a  toggle  for the  StoreSize option
  7060.             MTA.CTL. When you use this  option to SET the option  to ON,
  7061.             {ext} (optional)  can be  used to  set the  extension of the
  7062.             semaphore file  (default XS1)  to something  else (F#D  when
  7063.             running FileDoor 2.03 or older betas);
  7064.  
  7065.  ┌─────────────────────────────────────────────────────────────────────┐
  7066.  │ /STONAM{nam}                                                        │
  7067.  └─────────────────────────────────────────────────────────────────────┘
  7068.  Function : /STONAM  is  used   as  a  toggle  for the  StoreName option
  7069.             MTA.CTL. When you use this  option to SET the option  to ON,
  7070.             {nam} (optional)  can be  used to  set the  filename of  the
  7071.             semaphore  file  (default  FILEDOOR.XS2)  to  something else
  7072.             (FILEDOOR.F#D when running older FileDoor betas);
  7073.  
  7074.  ┌─────────────────────────────────────────────────────────────────────┐
  7075.  │ /STOCOM{nam}                                                        │
  7076.  └─────────────────────────────────────────────────────────────────────┘
  7077.  Function : /STOCOM is used  as  a  toggle  for the  StoreComment option
  7078.             MTA.CTL. When you use this  option to SET the option  to ON,
  7079.             {nam} (optional)   can  be   used  to   set the  name of the
  7080.             semaphore file (default FILEDOOR.XS3) to something else.
  7081.  
  7082.  
  7083.  
  7084.  
  7085.  4.1.3 Command-line parameters with a special usage
  7086.  ───────────────────────────────────────────────────────────────────────
  7087.  The following command-line parameters  are special (should not  be used
  7088.  but  are  documented  to  be  complete)  or  are only used in debugging
  7089.  situations.
  7090.  
  7091.  
  7092.  ┌─────────────────────────────────────────────────────────────────────┐
  7093.  │ /|                                                                  │
  7094.  │ />                                                                  │
  7095.  │ /<                                                                  │
  7096.  └─────────────────────────────────────────────────────────────────────┘
  7097.  Function : These options should (and can not) be used. They can not  be
  7098.             executed  from  the  DOS  command-line  because  they   have
  7099.             something to do  with piping. These  command-line parameters
  7100.             are used by MTA internally !
  7101.  
  7102.  ┌─────────────────────────────────────────────────────────────────────┐
  7103.  │ /PAUSE                                                              │
  7104.  └─────────────────────────────────────────────────────────────────────┘
  7105.  Function : Sometimes MTA will execute a program (archiver, virus  scan,
  7106.             exit  and  so  on)  and  this  programs reports an error. In
  7107.             these cases  you are  not able  to see  what happens because
  7108.             MTA  will  go  on  (after  a  warning  is given). If you use
  7109.             /PAUSE, MTA will pause  (without clearing the screen)  after
  7110.             the shell returns to MTA.  You must press [ESC] to  continue
  7111.             MTA in the normal way;
  7112.  
  7113.  
  7114.  
  7115.  4.2 Aborting MTA
  7116.  ───────────────────────────────────────────────────────────────────────
  7117.  There is only one way to abort MTA before it's normal end. When MTA  is
  7118.  busy, you  can press  [ESC]. MTA  will (in  time) display  that it will
  7119.  terminate soon.  Termination will  be done  AFTER THE  CURRENT FILE  IS
  7120.  CONVERTED !
  7121.  
  7122.  When you did  press [ESC] by  mistake, you can  always press any  other
  7123.  key  to  release  the  pending  termination.  In  that  case,  MTA will
  7124.  continue as normal.
  7125.  
  7126.  The termination option  does NOT work  when you use  the /D switch.  In
  7127.  this case you must wait until the diskette is fully converted.
  7128.  
  7129.  
  7130.  
  7131.  4.3 LOG file
  7132.  ───────────────────────────────────────────────────────────────────────
  7133.  MTA makes a log of almost  everything (unless you specify NoLog in  the
  7134.  MTA.CTL file or supply  /L as a runtime  switch).  You can  browse thru
  7135.  the log with a program like V.Buerg's LIST or with the 'good old'  TYPE
  7136.  command.
  7137.  
  7138.  The log-style can  be adjusted to  the users need  with three different
  7139.  options  (LogStyleFormat,  LogDateFormat  and  LogTimeFormat). Also you
  7140.  can combine  all possible  logs (the  'normal' log,  called MTA.LOG  by
  7141.  default, the  password log,  called MTA.PWN  by default  and the random
  7142.  password log,  called MTA.PWD  by default)  into one  log-file, because
  7143.  MTA will open  (APPEND) and close  the log for  every record it  has to
  7144.  write.
  7145.  
  7146.  Depending on the number of files  MTA has to convert, the MTA.LOG  file
  7147.  can get very large. I have  supplied a program (MTL.EXE) to solve  this
  7148.  problem. With  MTL.EXE you  can make  a statistical  review of your log
  7149.  file. In addition,  you can instruct  MTL to shorten  the log-file. MTL
  7150.  will rewrite the MTA.LOG file with only the total counters so far.  The
  7151.  next run MTL  will detect these  counters again and  adjust the current
  7152.  counters with these values.
  7153.  
  7154.  MTL depends  on the  format of  the log-file.  Therefor you  should not
  7155.  make any changes to the current  log-file, but make a copy of  the file
  7156.  and  work  on  the  copy  and  not  the original. MTL IS able to detect
  7157.  customized log-files  and will  adjust itself  to search  at the  right
  7158.  places. Also, records of a different  kind can be available in the  log
  7159.  (in case of a mailer or BBS program). MTL will skip these records  but.
  7160.  If  you  want  to  clean  the  log  with  MTL, MTL will ALSO remove all
  7161.  NON-MTA data from the log !
  7162.  
  7163.  If you get tired of the log, delete it, and MTA will create a new  one.
  7164.  When MTA calls itself as a child invocation, the child MTA does not  do
  7165.  any type of logging !
  7166.  
  7167.  
  7168.  
  7169.  4.4 Errors
  7170.  ───────────────────────────────────────────────────────────────────────
  7171.  Under some conditions, MTA can  abort (or skip files) which  causes the
  7172.  temporary directory to  stay on disk.  Normally MTA will  try to remove
  7173.  all files  from this  temporary directory  but there  can be cases when
  7174.  this is impossible. In such cases,  MTA will report this at the  end of
  7175.  the run. In that case you  must correct the errors manually and  remove
  7176.  the  directory  (or  directories)  from  disk. Under normal conditions,
  7177.  this  will  only  take  place  with  critical errors (disk failures and
  7178.  such).
  7179.  
  7180.  ┌───────┬─────────────────────────────────────────────────────────────┐
  7181.  │   5   │ Version information and credits                             │
  7182.  └───────┴─────────────────────────────────────────────────────────────┘
  7183.  
  7184.  5.1 The BETA-team
  7185.  ───────────────────────────────────────────────────────────────────────
  7186.  Look into  the file  SUPPORT.MTA for  a full  list of  all beta-testers
  7187.  and support nodes.
  7188.  
  7189.  
  7190.  
  7191.  5.2 Credits
  7192.  ───────────────────────────────────────────────────────────────────────
  7193.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  7194.  BETA team):
  7195.  
  7196.  - All   paying, registered   users. You   made it   possible to enhance
  7197.    MTA with nice features;
  7198.  
  7199.  - All users who did write me bug reports, suggestions and so on;
  7200.  
  7201.  
  7202.  
  7203.  5.3 Version history
  7204.  ───────────────────────────────────────────────────────────────────────
  7205.  ┌───────┬────────────────────────────┐
  7206.  │ 11.xx │ Sampled release info       │
  7207.  └───────┴────────────────────────────┘
  7208.   ■ Bug fixes;
  7209.  
  7210.   ■ Added   FilesBBSFormat   option,   CarryComment   option,  alternate
  7211.     CTL support, combination of /M and /D allowed;
  7212.  
  7213.  
  7214.  ┌───────┬────────────────────────────┐
  7215.  │ 12.xx │ Sample release info        │
  7216.  └───────┴────────────────────────────┘
  7217.   ■ Bug fixes;
  7218.  
  7219.   ■ All  tables  to  255   entries,  tag-menu,  /@,  /MD,    AltDisplay,
  7220.     internal swapping   (SwapPath,  NoSwap),   MDCD  support   (MDPath),
  7221.     IncludeCTL, AV-aware,  encryption   aware,  configurable   log-file,
  7222.     MTAErrorPath, extended help, mouse  aware, ITS aware and  many, many
  7223.     more changes;
  7224.  
  7225.  
  7226.  ┌───────┬────────────────────────────┐
  7227.  │ 13.xx │ Sample release info        │
  7228.  └───────┴────────────────────────────┘
  7229.   ■ MTA swapped from  free-ware to shareware so  now a small price  must
  7230.     be payed for continued usage;
  7231.  
  7232.   ■ Several bugs fixed;
  7233.  
  7234.   ■ Added support for 4DOS descriptions, EGA/VGA special text-modes
  7235.  
  7236.  
  7237.  ┌───────┬────────────────────────────┐
  7238.  │ 14.xx │ Sample release info        │
  7239.  └───────┴────────────────────────────┘
  7240.   ■ Fixed some bugs;
  7241.  
  7242.   ■ Added  support  for  volume-labels  (ZIP/ARJ),  special   log-files,
  7243.     descriptions, substituted drives  (recursive support), VGA  support,
  7244.     special selections (/LVLx),  sharing and multi-tasking  (also multi-
  7245.     MTA), ARJ, multiple  virus scanners, HYP(er),  PKLITE, menu-tagging,
  7246.     better help, LZH 2.xx support, videomode, TICK, FES, untyped  files,
  7247.     simulation, macros in  the password command-line  parameters, remote
  7248.     logging, files that are too old, XARC/ARCE, ZOO 2.xx,
  7249.  
  7250.  
  7251.  ┌───────┬────────────────────────────┐
  7252.  │ 15.01 │ Major Release              │
  7253.  └───────┴────────────────────────────┘
  7254.   ■ I did  an almost complete  rewrite of the  documentation. Many cross
  7255.     references are now explained at their proper locations, old info  is
  7256.     removed  (a  couple  of  chapters),  all  options  and  command-line
  7257.     parameters  are  revised  and  (I  hope)  better explained. The only
  7258.     thing that still is  on the list, is  an index and a  proper utility
  7259.     to create the  page numbers for  the various users.  Overall the new
  7260.     documentation is  somewhat smaller  than the  previous version while
  7261.     still giving you all relevant information;
  7262.  
  7263.   ■ The  internals of  MTA have  changed completely.  This causes MTA to
  7264.     use almost  the same  amount of  memory as  before though  there are
  7265.     many options added.  There is also  a separate overlayed  version of
  7266.     MTA  available  (MTAOVR)  that  uses  100K  less  of  (conventional)
  7267.     memory;
  7268.  
  7269.   ■ There was  a serious bug  in the RAPATHS  option logic, causing  MTA
  7270.     not  to  recognize  the  FILES.RA  file.  This is fixed. The RAPATHS
  7271.     option is  somewhat changed  in syntax  and the  RA0 and RA1 options
  7272.     are removed from MTA;
  7273.  
  7274.   ■ The  dos-shell  in  MTA  (you  know, the little window) was  getting
  7275.     somewhat old for the current state  of the technique.  The same  was
  7276.     true for  the swapping  routines. They  are all  replaced and we now
  7277.     have 4  new DOS-shell  routines in  MTA (2  non swapped,  2 swapped,
  7278.     each pair consisting of  a windowed and non-windowed  routine). This
  7279.     also  causes  archivers  that  needed  a  swap,  to  stay inside the
  7280.     DOS-window  as  were  the  non-swapped  archivers.  Because of these
  7281.     changes the  STOWBUFFER and  FORCECGA options  are removed  from MTA
  7282.     and are now obsolete;
  7283.  
  7284.   ■ Changed  the logic  for AV'ed  files. Previous  versions would  give
  7285.     errors under special conditions. This problem is fixed;
  7286.  
  7287.   ■ Fixed a problem  where MTA could make  a mess of ARJ  AV'ed archives
  7288.     (if KEEPAV was  set) in combination  with AutoDescription. If  these
  7289.     conditions  were  met  (KEEPAV,  ARJ-AV,  AutoDescription)  and  the
  7290.     target was ZIP, MTA would  add a description to the  ARJ-file, using
  7291.     internal patching techniques, causing  the target-file to be  defect
  7292.     (you could still extract them, but with a warning). This is fixed;
  7293.  
  7294.   ■ Changed  the  logic  for  SFX  files. Previous versions did  contain
  7295.     their own  logic to  remove the  SFX-header from  the archives. This
  7296.     coding is removed  and MTA should  be able to  convert SFX files  if
  7297.     the  archiver  can  extract  files  from  the  SFX'ed  file.  By  my
  7298.     knowledge,  there  is  only  one  non-standard SFX-file. This is the
  7299.     ZOO-SFX created  with a  separate program.  These files  can not  be
  7300.     converted when ZOO  is not able  to decompress files  from the *.EXE
  7301.     files.  Overall,  this  will  give  a  much more secure (and version
  7302.     independent) result;
  7303.  
  7304.   ■ The  /M  (MOVETOPATH)  command-line  parameter  could  be used  with
  7305.     invalid directory names. MTA would report errors when the  converted
  7306.     files  was  actually  moved  to  this  directory  or a file would be
  7307.     renamed (convert RA_110.ZIP to ZIP,  with /MTRA where TRA was  not a
  7308.     valid directory.  The result  was a  file TRARA_11.ZIP  and the file
  7309.     was still  in the  current directory).  This logic  has been changed
  7310.     and fixed;  MTA will  now validate  the supplied  directory and will
  7311.     abort  (before  the  conversion)  if  there  is an invalid directory
  7312.     supplied;
  7313.  
  7314.   ■ Previous versions  of MTA could  not work with  generic directories.
  7315.     You  always  had  to  include  the  full pathname (directory and the
  7316.     drive   name).   When   reading   options   from   MTA.CTL  and  the
  7317.     command-line, MTA will  now expand generic  paths (/M.. or  /Z\ZIP\)
  7318.     to full names, based on  the current directory and drive.  Be warned
  7319.     though.  If  the  generic  path  results in an expanded NON-existing
  7320.     path, MTA will abort with an error;
  7321.  
  7322.   ■ MTA would fail the extended test when ARJ files were converted  that
  7323.     contained files, archived with -t1. These files can be found in  the
  7324.     original ARJxxx.EXE distribution  file (just run  a verbose list  of
  7325.     this archive,  write down  the length  of all  files, decompress the
  7326.     file, run a  DIR and compare  the lengths) and  all other ARJ  files
  7327.     that are created with the  -t1 ARJ command-line parameter. MTA  will
  7328.     now ignore the extended test when dealing with such ARJ archives;
  7329.  
  7330.   ■ In certain cases, MTA would forget to clean the temporary  directory
  7331.     when an extended test failed. This is fixed;
  7332.  
  7333.   ■ MTA will now FULLY ignore the ARJ_SW environment variable. MTA  will
  7334.     pass a  command-line parameter  to ARJ  (2.21 and  higher) that will
  7335.     force ARJ NOT  to look at  this env.var.. All  additional options in
  7336.     this env.var. must be added to the ARJCompression option;
  7337.  
  7338.   ■ MTA will still give a beep EVEN when the WarningTime option was  set
  7339.     to 0. This is fixed;
  7340.  
  7341.   ■ CarryComment would  sometimes be unable  to find the  comment in the
  7342.     FILES.BBS alike file. Fixed;
  7343.  
  7344.   ■ The full-screen picklist would 'flicker' when you pressed F1  (help)
  7345.     more than once. Fixed;
  7346.  
  7347.   ■ Sometimes MTA would screw up  the first file inside a PAK  SFX file.
  7348.     This is fixed;
  7349.  
  7350.   ■ MTA  would truncate  the log-file  when it  became bigger  than 64K.
  7351.     This is fixed;
  7352.  
  7353.   ■ MTA  would consume  8K blocks  of conventional  memory when the TICK
  7354.     support was on. This is fixed;
  7355.  
  7356.   ■ The documented  /CO command-line parameter  (to overrule the  option
  7357.     ZOOCOMPRESSION) did cause MTA to  fail. It has now been  included in
  7358.     MTA.EXE under the name /CQ;
  7359.  
  7360.   ■ MTA would sometimes not  remove directories. This happened when  MTA
  7361.     needed to access various drives. This is fixed;
  7362.  
  7363.   ■ Sometimes  MTA  would  display  a  very huge number of  uncompressed
  7364.     bytes for ARJ files (causing MTA to skip the file if that number  of
  7365.     bytes was not available on the hard-disk). This is fixed;
  7366.  
  7367.   ■ Under  4DOS (4.0  and higher),  MTA would  show a  cursor after  the
  7368.     first MOVE. This is fixed. MTA will hide the cursor after each  call
  7369.     to an external program (4DOS is one of them);
  7370.  
  7371.   ■ Various problems  with TBSCAN 2.9,  3.1 and 3.2  are fixed (look  at
  7372.     the  new  command-line  examples  for  this scanner). When using MTA
  7373.     under  DesqView  (with  SHARE),  you  MUST  use TBSCAN 3.2 or higher
  7374.     because older versions will deny the removal of files and  directory
  7375.     that MTA  (not TBSCAN!!)  has created.  The 3.2  works fine with the
  7376.     new coding in MTA  if you (at least)  use the -compat option  of the
  7377.     TBSCAN program;
  7378.  
  7379.   ■ Various problems  with HTSCAN 1.6  (and lower). Some  of them caused
  7380.     by MTA (fixed) and one of them caused by HTSCAN. When HTSCAN has  to
  7381.     run in 200Kb or less, it would cause MTA to report that the  archive
  7382.     contained a virus. The author of HTSCAN will change this bug in  the
  7383.     next version  and MTA  can now  work with  HTSCAN's new error-levels
  7384.     because of a change in the VIRUSSCANNER option;
  7385.  
  7386.   ■ Added %D macro  in the VIRUSSCANNER option.  %P (as before) will  be
  7387.     expanded to the complete  directory to scan (without  filenames), %F
  7388.     will be  expanded to  the complete  directory plus  \*.*. %D will be
  7389.     expanded to the  last branch (node)  in the temporary  directory and
  7390.     is a relative directory. This  macro can be used in  complex network
  7391.     structures;
  7392.  
  7393.   ■ Mouse  support  in  the  main  MTA-body  is  removed.  It  is  still
  7394.     available in the full-screen  pick-list. The NOMOUSE option  and the
  7395.     /NOMOUSE command-line parameter are removed from MTA;
  7396.  
  7397.   ■ Older versions of  MTA would rename the  target file if a  file with
  7398.     the same name existed  on the target location.  You can now add  the
  7399.     OVERWRITEDUPLICATES option  to force  MTA to  overwrite such  files.
  7400.     The new target-file will overwrite a file with the same name in  the
  7401.     target directory;
  7402.  
  7403.   ■ The  /CTL  command-line  parameter  is  enhanced.  You can now  also
  7404.     supply a filename (without  path) if that file  can be found in  the
  7405.     DOS  PATH,  the  current  directory  or  the directory where MTA.EXE
  7406.     (MTAOVR.EXE) is found (last option only under DOS 3.xx and higher);
  7407.  
  7408.   ■ The EXCLUDEFILE  and DONOT options  now accept wildcards,  including
  7409.     the '=' wildcard (see documentation);
  7410.  
  7411.   ■ Remote  operations (introduced  in the  14.5x versions  of MTA)  was
  7412.     only  possible  when  the  /REMOTE  command-line parameter was used.
  7413.     The REMOTE option for MTA.CTL is added;
  7414.  
  7415.   ■ MTA  will  now  do  remote  logging (modem communications) when  the
  7416.     REMOTE option or  /REMOTE command-line parameter  is set along  with
  7417.     non-zero  values  for  BAUD  and  COM-port.  If  either of these two
  7418.     contains  a  zero  (/BAUD0  and/or  /COM0),  MTA will not use remote
  7419.     logging;
  7420.  
  7421.   ■ Added  the /ANS  command-line parameter.  Normally MTA  will do  its
  7422.     remote logging in ANSI-mode. When /ANS0 is used, MTA will use  plain
  7423.     ASCII.  /ANS1  and  higher  values  (up  to  /ANS9)  will cause ANSI
  7424.     logging;
  7425.  
  7426.   ■ Added  the  NOBEEP  option.  When  WarningTime is set to a  non-zero
  7427.     value (nice  when running  unattended BUT  WITH remote  logging) you
  7428.     can still shut down the beeps and bells;
  7429.  
  7430.   ■ Added  the  /PAUSE   command-line  parameter  (no  counterpart    in
  7431.     MTA.CTL).   When present,  MTA will  halt until  you press ESC after
  7432.     EACH call to an external program. Added for debugging;
  7433.  
  7434.   ■ Added coding so  you can abort MTA  when it is waiting  for a locked
  7435.     (shared) file. If you press CTRL-E, MTA will abort from the lock;
  7436.  
  7437.   ■ Added  the NOEMS  and NOXMS  options in  MTA.CTL and  the /NOEMS and
  7438.     /NOXMS command-line parameters, to force  MTA NOT to use EMS  and/or
  7439.     XMS while swapping itself from memory;
  7440.  
  7441.   ■ Changed the logging.  The following changes have  been made:
  7442.  
  7443.     - All  records   have   been   split   into   single-item     lines,
  7444.       containing the needed info in the smallest number of bytes;
  7445.  
  7446.     - The  errors are   now recorded  in   the normal   log-file. As   a
  7447.       result  of  this change, the  ERRORLOGPATH option is  removed from
  7448.       MTA;
  7449.  
  7450.     - MTA and MTL  work with  the new log. If you convert to  15.01, you
  7451.       must run  the previous  MTL version  (with log-compression) before
  7452.       you start  using MTA  and MTL  unless   you   do   not   need  the
  7453.       statistics  inside  the log-file;
  7454.  
  7455.     - MTA  now uses  its own  codes (MTL  will also  use them):
  7456.  
  7457.       * error message
  7458.       ! important  information
  7459.       $ extra      information
  7460.       = status     information
  7461.       ~ password   information
  7462.       # conversion information  (needed by MTL)
  7463.       @ MTL        information (created by MTL)
  7464.  
  7465.   ■ Changed   the syntax   of the   xxxPATH options   (see documentation
  7466.     for  the  current  format).  This  was   done to change the swapping
  7467.     function and  to   add   alternative   archiver  versions.    PLEASE
  7468.     READ   the documentation carefully !
  7469.  
  7470.   ■ Added a cheap  alternative to archive-marking (NOMARKED  and related
  7471.     options) with the ONLYNEWFILES  option and/or the /NEW  command-line
  7472.     parameter. Only files that are newer than the file-date of the  file
  7473.     FILES.MTA in the working directory, are converted. MTA will  (re)set
  7474.     the file FILES.MTA itself;
  7475.  
  7476.   ■ At the risk  of loosing some friend,  I include the following  text.
  7477.     It  has  become  general  practice  for  some BBS's to add their own
  7478.     AV-code to ARJ and  ZIP files. In my  views the AV-code is  meant to
  7479.     tell the user  that a certain  file is untouched  after it has  been
  7480.     created by the  author. When a  BBS includes AV-codes,  it will mean
  7481.     that the file is  untouched after it has  been created by the  SYSOP
  7482.     (not the author) and that  is ALMOST useless information. It  can be
  7483.     used  as  long  as  ORIGINAL  AV-codes  are left unaltered but it is
  7484.     misleading  users  when  original  AV-codes  ARE  altered. With this
  7485.     practice, it is almost useless  to keep AV codes inside  the archive
  7486.     because you (as user/sysop) only  have the advertisement of the  BBS
  7487.     as  added  value.  To  (partially)  overcome  this  problem, MTA now
  7488.     contains an option INCLUDEAVFILES. If this option is NOT present  in
  7489.     MTA.CTL and KEEPAV is set, all AV'ed files are still unaltered.   If
  7490.     you include one or more  INCLUDEAVFILES options, and KEEPAV is  set,
  7491.     MTA will only keep the AV code for the files that match one or  more
  7492.     of  the  INCLUDEAVFILES  file-masks.  ALL  other AV'ed files will be
  7493.     converted EVEN when  KEEPAV is set.  One of the  next minor versions
  7494.     of MTA will extend this option  in a very dynamic (and more  secure)
  7495.     way;
  7496.  
  7497.   ■ Added  dynamic swapping.  In the  previous versions  you could  only
  7498.     tell to ALWAYS swap before the  call to another program was made  or
  7499.     to NEVER swap before the call  to another program was made.   Though
  7500.     this  function  was  variable  for  each  different  (de)compression
  7501.     program, it was somewhat rough. You can now supply a minimum  number
  7502.     of bytes that  must be available  in memory (conventional).  If this
  7503.     number of  bytes (or  more) is  available, MTA  will NOT swap itself
  7504.     out of  the way.  If it  isn't available,  MTA WILL  swap before the
  7505.     call  is  made.  Dynamic  swapping  is  now available in all xxxPATH
  7506.     options  (as  a  replacement  for  the  older  SWAP  value  in these
  7507.     options) and is added to the VIRUSSCANNER and all EXITxxx options;
  7508.  
  7509.   ■ Removed  the NOSWAP  option from  MTA. It  became obsolete after the
  7510.     introduction of dynamic swapping;
  7511.  
  7512.   ■ Added alternative archive-program  versions in the xxxPATH  options.
  7513.     Added the  /ALT command-line  parameter to  activate the alternative
  7514.     versions. See the chapter about the usage of alternative versions;
  7515.  
  7516.   ■ Added  support  for  SFX  (TARGET!!)  files. You can now create  SFX
  7517.     files as  the target.  To support  this option,  the values  ZIPSFX,
  7518.     ARJSFX,  LZHSFX  and  PAKSFX  can  be  used  as  the  value  for the
  7519.     COMPRESSIONTYPE  option.  Also  the  /ZIPSFX,  /ARJSFX,  /LZHSFX and
  7520.     /PAKSFX command-line parameters can now be used. Also added are  the
  7521.     ASFCOMPRESSION,  LSFCOMPRESSION  and  ZSFCOMPRESSION  options to add
  7522.     extra parameters to the  call to the archive-program  (when creating
  7523.     SFX files). The /CJS, /CLS  and /CZS command-line parameters can  be
  7524.     used  to   over-  rule   the  ASFCOMPRESSION,   LSFCOMPRESSION   and
  7525.     ZSFCOMPRESSION options.   The ZIP2EXEPATH option  is added to  point
  7526.     to the ZIP2EXE.EXE program;
  7527.  
  7528.   ■ MTA will also convert  archives inside archives (arc-in-arc) to  SFX
  7529.     files (when one of the xxxSFX  options is set) so the customer  does
  7530.     not need any decompression program to decompress the file;
  7531.  
  7532.   ■ Added support for GIFLITE.  You can now convert normal  GIF-files to
  7533.     the GIFLITE format when the  target is set to GIFLITE.  When running
  7534.     a  GIF->GIFLITE  conversion,  no  normal  archives  can (or will) be
  7535.     converted  so  'MTA  *.ZIP  /GIFLITE'  will  have  no  meaning.   To
  7536.     implement   this    function,    the   options    GIFLITEPATH    and
  7537.     GIFLITECOMPRESSION are added as well as the 'GIFLITE' value for  the
  7538.     COMPRESSIONTYPE  option.    The  /CGL   and  /GIFLITE   command-line
  7539.     parameters are also added;
  7540.  
  7541.   ■ Added support  for GIFTEST. You  can now test  GIF-files (normal and
  7542.     lite) when the target is set  to GIF. When running GIF->GIF test  no
  7543.     normal archives can (or will) be converted so 'MTA *.ZIP /GIF'  will
  7544.     have  no   meaning.  To   implement  this   function,  the   options
  7545.     GIFTESTPATH and GTECOMPRESSION are added as well as the 'GIF'  value
  7546.     for the  COMPRESSIONTYPE option.   The /CGT  and /GIF  command- line
  7547.     parameters are also added;
  7548.  
  7549.   ■ Added support for JPEG. You can now convert normal GIF-files to  the
  7550.     JPEG format  when the  target is  set to  GIF2JPG and  you can  also
  7551.     convert JPEG  (.JPG) files  back to  GIF when  the target  is set to
  7552.     JPG2GIF.  When  running  a  GIF->JPEG  or  JPEG->GIF  conversion, no
  7553.     normal archives can (or will) be converted, so 'MTA *.ARJ  /GIF2JPG'
  7554.     will have  no meaning.   To implement  these functions,  the options
  7555.     GIF2JPGPATH,  JPG2GIFPATH,  G2JCOMPRESSION  and  J2GCOMPRESSION  are
  7556.     added,  as  well  as  the   values  GIF2JPG  and  JPG2GIF  for   the
  7557.     COMPRESSIONTYPE  option.   The  /C2J,  /C2G,  /GIF2JPG  and /JPG2GIF
  7558.     command-line parameters are also added;
  7559.  
  7560.   ■ Added the MAXGIFDIM option to narrow the selection of GIF-files  for
  7561.     GIFLITE (unregistered version of GIFLITE);
  7562.  
  7563.   ■ Changed the full-screen picklist  to include the correct files  when
  7564.     one of the GIF-alike  options is used in  MTA (you will now  see the
  7565.     usable GIF/JPG files and not archives);
  7566.  
  7567.   ■ Changed the  help-display (MTA /?)  to reflect the  new command-line
  7568.     parameters in MTA 15.01;
  7569.  
  7570.   ■ Added  logic  and  support  for  the  new  PKZIP  (1.93+)  deflating
  7571.     algorithm. MTA  will detect  these files  and will  convert them  if
  7572.     the   newer    PKZIP/PKUNZIP      is    used      (ZIPVERSION    and
  7573.     PKZIPPATH/PKUNZIPPATH set  to  1.93/2.01  values)  or  will   report
  7574.     the need  for a  higher version  of PK(UN)ZIP  is you  still use the
  7575.     1.10 (or lower);
  7576.  
  7577.   ■ /UPGRADE is changed. It can  now be used to convert from  PKZIP 1.xx
  7578.     type of archives to 2.xx (it was set to convert from 0.xx to 1.xx);
  7579.  
  7580.   ■ Added support and logic for  the new ARJ (2.30+). MTA will  not con-
  7581.     vert  backup  files  in  ARJ  archives.  You can add the SKIPBACKUPS
  7582.     option in MTA.CTL  (/SBA command-line parameter)  in which case  MTA
  7583.     will  skip  ZOO  and  ARJ  archives  that contain backup-versions of
  7584.     files. Also, the  extended testing will  be skipped if  these backup
  7585.     version are available  in the archive.  With the last  change, it is
  7586.     possible to convert  ARJ files with  backups (and also  ZOO for that
  7587.     matter). For ARJ you can choose to do a normal conversion (in  which
  7588.     case  the  backup  files  are  removed)  or  you  can  use a special
  7589.     command-line parameter in the  ARJCOMPRESSION option, in which  case
  7590.     ARJ will rename all backup-versions with a special extension;
  7591.  
  7592.   ■ Added a graphical bar when parsing the MTA.CTL;
  7593.  
  7594.  
  7595.  ┌───────┬────────────────────────────┐
  7596.  │ 15.02 │ Bug & minor release        │
  7597.  └───────┴────────────────────────────┘
  7598.   ■ MTA would report 'duplicate  file, extension changed to ...'  when a
  7599.     file was  checked with  the /SIM  mode. This  could alarm users that
  7600.     saw the message at the remote side. Fixed;
  7601.  
  7602.   ■ MTA would report 'Unable  to RmDir/MkDir/ChDir to .........' when  a
  7603.     file was  checked with  the /SIM  mode. This  could alarm users that
  7604.     saw the message at the remote side. Fixed;
  7605.  
  7606.   ■ MTA would report 'SIMULATE  MODE' and not 'SIMULATE MODE  [OVERLAY]'
  7607.     on the main  screen when the  overlayed version and  /SIM were used.
  7608.     Fixed;
  7609.  
  7610.   ■ MTA would report 'DATETEST  MODE' and not 'DATETEST MODE  [OVERLAY]'
  7611.     on the main  screen when the  overlayed version and  /SIM were used.
  7612.     Fixed;
  7613.  
  7614.   ■ MTA  /? would  always cause  a GOMTA.BAT  in the  current directory,
  7615.     even when no changes were made to the note-pad;
  7616.  
  7617.   ■ The pick-list would  display ALL files when  /GIF was used. This  is
  7618.     fixed so only .GIF files are showed;
  7619.  
  7620.   ■ Some cosmetic changes in the copyrights for the remote display;
  7621.  
  7622.   ■ The overlay  algorithm is somewhat  changed to speed  up the parsing
  7623.     of the MTA.CTL alike file;
  7624.  
  7625.   ■ Added the RemoteColor option  in MTA.CTL to alter the  remote colors
  7626.     so they can match  the BBS colors. The  default colors are the  same
  7627.     as the default colors for FileDoor <tm>;
  7628.  
  7629.  
  7630.  ┌───────┬────────────────────────────┐
  7631.  │ 15.05 │ Minor Release              │
  7632.  └───────┴────────────────────────────┘
  7633.   ■ MTA would report 'no compressor available' or something alike,  when
  7634.     ZIP files were involved. This could happen when you did not  include
  7635.     a ZIP2EXEPath option in MTA.CTL and/or ZIP2EXE.EXE was not found  in
  7636.     the DOS-path. This is fixed;
  7637.  
  7638.   ■ JPG2GIF would report  'no compressor' available or  something alike,
  7639.     when JPG  files were  involved. This  could happen  when you did not
  7640.     include a GIFTESTPath option  in MTA.CTL and/or GIFTEST.EXE  was not
  7641.     found in the DOS-path. This is fixed;
  7642.  
  7643.   ■ Under  some conditions  (errors), the  'bar' would  not display  the
  7644.     correct  values,  neither  did  some  of  the  counters.  Also  when
  7645.     multiple files were  converted and one  or more files  were invalid,
  7646.     the ratio (percentage) could  show incorrect values. This  is fixed.
  7647.     MTA will now  display counters for  invalid files (in  red) also and
  7648.     the normal  counters, ratio  and 'bar'  are modified  in the correct
  7649.     way;
  7650.  
  7651.   ■ Fixed a problem  with /P (toggle logging).  This was still a  toggle
  7652.     but could result in  errors. /P can now  only be used to  switch any
  7653.     current logging to OFF. Using the log-file, must be set in MTA.CTL;
  7654.  
  7655.   ■ Added a /NVI command-line option. When used, the virus-scanning  (of
  7656.     ALL configured scanners) will be skipped;
  7657.  
  7658.   ■ Enhanced the IncludeAVFile option. You can now (optionally)  include
  7659.     the AV-number  (security env.  number) of  the filemask.  It is  now
  7660.     possible to  filter the  correct files  from the  ones that  are not
  7661.     from the  original authors.  In the  past IncludeAVFiles  PKLTE*.EXE
  7662.     would cause PKLT113.EXE to pass  (keep its AV, when KeepAV  was also
  7663.     set) even when RVH012 was the  one that added the AV-code (and  that
  7664.     is  NOT  PKWare).  Now  you  can  add  the PKW655 code to the option
  7665.     (IncludeAVFile PKLTE*.* PKW655) to force only the keeping of the  AV
  7666.     is the file matches PKLTE*.* AND the AV-code is PKW655). Also  masks
  7667.     for the AV-code (numeric/alphanumeric masks) can be used;
  7668.  
  7669.   ■ Added the AVLogPath option which causes a log-file to be  maintained
  7670.     by MTA, that included AV-numbers  and their names (like 0000  Robert
  7671.     K Jung or PKW655 PKWare Inc). This file can be maintained by MTL;
  7672.  
  7673.   ■ Added several log-records to the normal log that have to do with  AV
  7674.     (security env.)  coded. The  values will  only be  used when  either
  7675.     AVLogPath is set OR  at least one or  more AV-codes are supplied  as
  7676.     parameters for the IncludeAVPath option(s);
  7677.  
  7678.   ■ Added the test for  the MTAOVRSZ environment variable (only  overlay
  7679.     version).  If  present  and  containing  a numeric value, this value
  7680.     will be used as overlay buffer. Using number above 56000 will  cause
  7681.     MTAOVR to run faster but will also cause MTAOVR to use more  conven-
  7682.     tional memory;
  7683.  
  7684.  
  7685.  ┌───────┬────────────────────────────┐
  7686.  │ 15.06 │ Minor Release              │
  7687.  └───────┴────────────────────────────┘
  7688.   ■ Fixed a problem with a  runtime error 200 when no valid  files could
  7689.     be processed. This is fixed (both overlay and normal version);
  7690.  
  7691.   ■ Changed the DoNot  option in a way  that you can also  supply paths.
  7692.     It is now  possible to exclude  complete directories with  the DoNot
  7693.     statement  (e.g.  DoNot  E:\TUP\DONOT\*.*)  or  partial  directories
  7694.     (e.g.  DoNot  E:\TUP\SOME\DONOT\*.ARJ).  This  option  also comes in
  7695.     handy in combination with the QBBSPaths and RAPaths option(s);
  7696.  
  7697.   ■ Added a ChildTouch  option so you can  use another type of  touching
  7698.     for nested archives;
  7699.  
  7700.  
  7701.  ┌───────┬────────────────────────────┐
  7702.  │ 15.07 │ Minor Release              │
  7703.  └───────┴────────────────────────────┘
  7704.   ■ Fixed all problems with READONLY, HIDDEN and SYSTEM files. MTA would
  7705.     not copy, delete, rename  and/or  move these files. Though they will
  7706.     not show up  in  archives very frequently, some users complained. It
  7707.     was a bug and therefore fixed;
  7708.  
  7709.   ■ Added support  for  those  virusscanners  that can only work good on
  7710.     complete  drives. Scanners  like  Central  Point  Software CPAV (1.2
  7711.     and up) can  now  be  run  in batch-mode but will run best when they
  7712.     can scan a  full  drive. In  these  cases  you  should use the SUBST
  7713.     support of  MTA (only  if  you have troubles with it, you SHOULD use
  7714.     this feature, if you HAVE problems, tell me);
  7715.  
  7716.   ■ Added examples (tested  by me or others) for Dr.Solomon's virus scan
  7717.     (FINDVIRU) and  Central  Point Software's CPAV (only 1.2 and higher,
  7718.     1.0 does  not  return  errorlevels  and I skipped 1.1, so don't know
  7719.     if this version already returns errorlevels);
  7720.  
  7721.   ■ The %D macro in the VirusScanner option was not included in the DOCs
  7722.     (it is now) and there is a much better description of all the macros
  7723.     that you can use in this option (including the new %S and %L macro);
  7724.  
  7725.  
  7726.  ┌───────┬────────────────────────────┐
  7727.  │ 15.07 │ Bug (?) Release            │
  7728.  └───────┴────────────────────────────┘
  7729.   ■ Reports got in  from  users about MTA in a OS/2 2.0ß DOS box. MTA is
  7730.     not able to find any file that the  user wants to select. This nasty
  7731.     problem *looks*  like a problem with OS/2 2.0 because the normal DOS
  7732.     (ALSO IBM PC-DOS 5.0) works fine and the problems  involved  have to
  7733.     do with DOCUMENTED interrupts and NORMAL  Turbo  Pascal  processing.
  7734.     Thanks to some willin beta-testers I was able  to track the  problem
  7735.     down. This release contains a work-around that even causes MTA to be
  7736.     somewhat smaller and still giving the same functions. Under OS/2 2.0
  7737.     DOS boxes it *should* work again (as it did with beta-testers). Look
  7738.     into HELP__ME.MTA for questions about OS/2 2.0ß because  I don't run
  7739.     this operating system and must rely on the input from users who do !
  7740.  
  7741.  
  7742.  ┌───────┬────────────────────────────┐
  7743.  │ 15.10 │ Minor Release              │
  7744.  └───────┴────────────────────────────┘
  7745.  Several requests from users have  been addressed in this release.  Also
  7746.  please read the Q&A.MTA file (if it is present inside the archive).
  7747.  
  7748.   ■ Fixed another file-selection mask  (OS2 problem) in MTA.CH1. Also  a
  7749.     couple of OS2 beta-testers have  reported me that IBM has  addressed
  7750.     the problem  and that  there is  a fix-file  in the  later OS2 betas
  7751.     that can solve the problem;
  7752.  
  7753.   ■ Added the FileIDDiz option.  When active, it will store  the comment
  7754.     inside this  file into  memory. This  comment can  later be added to
  7755.     FILES.BBS (when ADDFilesBBS  is on) and/or  into the semaphore  file
  7756.     for the protocol-driver (StoreComment and /STOCOM, see later);
  7757.  
  7758.   ■ StoreSize, StoreName  (see later) and  StoreComment (see later)  can
  7759.     now also work  when remote operation  is NOT the  case. Normally you
  7760.     should  use  the  command-line  options  (/STOSIZ, /STONAM, /STOCOM)
  7761.     when you run MTA under a  door (FileDoor). When you set the  options
  7762.     in MTA.CTL  they will  work also  when remote  operation is  NOT the
  7763.     case (again,  unless you  toggle the  options to  OFF with  the same
  7764.     command-line parameters as mentioned before);
  7765.  
  7766.   ■ StoreSize  (/STOSIZ)  has  been  expanded.  You  can now supply  the
  7767.     extension of the file (normally xxxxxxxx.XS1) when the caller  needs
  7768.     to access another extension  (FileDoor 2.03 will need  the extension
  7769.     F$D);
  7770.  
  7771.   ■ Added  the StoreName  (/STONAM) option.  It will  create a file with
  7772.     old and new names that can be used by  a  protocol-driver  like  the
  7773.     FileDoor program. Only FileDoor 3.01 (and up)  will  work  with this
  7774.     semaphore file;
  7775.  
  7776.   ■ Added the StoreComment (/STOCOM) option. It will create a file  with
  7777.     comments from the header  or FILE_ID.DIZ file. It  can be used by  a
  7778.     protocol driver to overrule (supply) the comment of uploaded  files;
  7779.  
  7780.   ■ Added  SubstOn  and  SubstOff  options  to  overrule  the   internal
  7781.     sequence  that  MTA  uses  when  paging directories to a substituted
  7782.     drive;
  7783.  
  7784.   ■ The warning for using a Substituted drive is reversed. You will  now
  7785.     get a flashy warning when NOT using a substituted drive;
  7786.  
  7787.   ■ Added  the %T  macro in  all exit-calls  that can  be used to assign
  7788.     different  batch-files  for  different  tasks (when running multiple
  7789.     tasks);
  7790.  
  7791.   ■ The call to  LABEL.COM/EXE has been removed.  MTA will now use  some
  7792.     internal coding to reset the volume-label to the original label  (or
  7793.     a dummy when no label was set), when archives contain volume  labels
  7794.     inside;
  7795.  
  7796.   ■ The  CarryComment  option  did  only  allow  the first 255 bytes  of
  7797.     archive-comments to  be carried  over to  the new  archive. This has
  7798.     been enhanced to  64K of comment.  There are several  special tricks
  7799.     involved to  deal with  ARJ-comments in  this matter  because of the
  7800.     'multi-platform' 'compatible' matter  ARJ stores the  comment inside
  7801.     the  archives  (removing  part  of  the CR/LF sequence, resulting in
  7802.     problems when carried over to other archivers);
  7803.  
  7804.  
  7805.  ┌───────┬────────────────────────────┐
  7806.  │ 15.20 │ Major sub-release          │
  7807.  └───────┴────────────────────────────┘
  7808.  Several requests from users have  been addressed in this release.  Also
  7809.  take some  time to  sort out  the *.TEC  files included  (if any)  that
  7810.  cover special subjects more deeply.
  7811.  
  7812.   ■ Fixed a problem for non-registered usage where the MTA-childs  would
  7813.     all wait for a certain time (will work on most machines);
  7814.  
  7815.   ■ Fixed a problem for non-registered usage where the MTA under  remote
  7816.     operations would wait 90 seconds. This is reduced to 10 seconds;
  7817.  
  7818.   ■ MTA could be  called twice (again within  a DOS shell of  MTA). This
  7819.     is  fixed  for  most  configurations.  Only  MTA itself can call new
  7820.     copies of MTA (child processing);
  7821.  
  7822.   ■ When  displaying  message  remote  (BBS  under a door like  FileDoor
  7823.     <tm>) MTA would not restore  the color to the original  color before
  7824.     MTA was called. This is fixed;
  7825.  
  7826.   ■ When MTA  called the FOSSIL  to init remote  operations, the display
  7827.     could be trashed  if the FOSSIL  reported itself. MTA  will now save
  7828.     and restore the screen before and after the call to the  FOSSIL-init
  7829.     routine;
  7830.  
  7831.   ■ When  running under  multi-taskers (Desqview  etc.) MTA  would still
  7832.     try  to  change  the  video-mode  if  the VIDEOMODE option was used.
  7833.     This is fixed. VIDEOMODE will have no meaning under multi-tasking;
  7834.  
  7835.   ■ Fixed a problem (enhancement)  where +-comment lines were not  moved
  7836.     along with the  original file-comment in  the FILES.BBS alike  file.
  7837.     MTA will now move these +-comment lines;
  7838.  
  7839.   ■ GIF  files were  not touched  (and kept  their original  date). When
  7840.     TouchCur (also the new format,  see later), TouchHig or TouchLow  is
  7841.     the default,  GIF files  are touched  with the  current date  (or an
  7842.     added number of days, see new TouchCur format);
  7843.  
  7844.   ■ Files that were marked in  error (in the first 'TESTING' pass)  were
  7845.     not moved to the error-directory. This is fixed;
  7846.  
  7847.   ■ OverwriteDuplicates  only worked  for converted  files. It  will now
  7848.     also work  for moving  (with overwrite)  to the  error-directory and
  7849.     (if needed) the trashcan-directory;
  7850.  
  7851.   ■ Some users were reporing  problems with the child-call. As  a result
  7852.     of the rather  short command-line (110  bytes) under DOS,  MTA could
  7853.     fail with arc-in-arc files (child calls) because a longer  parameter
  7854.     was needed.  Now MTA  will pass  the command-line  parameters to the
  7855.     child-MTA thru  a file.  The file  is placed  in the  same directory
  7856.     where  MTA.EXE  (MTAOVR.EXE)  is  placed  OR  will  be placed in the
  7857.     directory that is pointed to by the TEMP environment variable;
  7858.  
  7859.   ■ Added  routines  and  coding to  work with SQZ archives. MTA already
  7860.     supports this archiver (like PKZIP 1.93a)  to  make  testing  rather
  7861.     simple. As a result of  this new archiver, the following options are
  7862.     added to MTA.CTL:
  7863.  
  7864.     - CompressionType SQZ
  7865.     - CompressionType SQZSFX
  7866.     - SQZPath
  7867.     - SQZCompression
  7868.     _ SSFCompression
  7869.  
  7870.     Also the following command-line switches are added:
  7871.  
  7872.     - /SQZ
  7873.     - /SQZSFX
  7874.     - /CS
  7875.     - /CSS
  7876.  
  7877.     They work the same as  their  counterparts for other archive programs
  7878.     like ZIP, ARJ and LZH;
  7879.  
  7880.   ■ Added MAXPATHS option with  same functions as RAPATHS and  QBBSPATHS
  7881.     but for Maxmimus <tm>;
  7882.  
  7883.   ■ Enhanced  the RAPATHS  option to  work with  RA 0.xx,  1.0x and 1.1x
  7884.     releases  of  Remote  Access  <tm>.  Also  CD-rom  areas for RA 1.1x
  7885.     releases are detected and ignored by MTA;
  7886.  
  7887.   ■ Enhanced the  QBBSPATHS option to  work with pre  2.75 releases (the
  7888.     MTA 15.10- situation) and 2.75+  releases of QuickBBS <tm>. The  pre
  7889.     2.75  format  (FLSEARCH.CTL)  remains   the  default  for   backward
  7890.     compatibility with MTA (will be altered in a later);
  7891.  
  7892.   ■ Added the  ExcludeDirectory option that  can be used  to exclude one
  7893.     or more  directories that  come from  RAPaths, QBBSPaths  and/or the
  7894.     new MAXPaths option;
  7895.  
  7896.   ■ Added  an  example  in  MTA.CTL  to  be used with the  virus-scanner
  7897.     (commercial) that is called GOBBLER <tm>;
  7898.  
  7899.   ■ Extended the usage  of the FILEIDDIZ option.  It is now possible  to
  7900.     let MTA use one of a set of files (not just only one);
  7901.  
  7902.   ■ Relaxed  the  testing  of  the  FILE_ID.DIZ alike file. In  previous
  7903.     releases  this  caused  many  warnings.  Because of the more dynamic
  7904.     usage of  comment-files (extended  FILEIDDIZ option),  MTA will  now
  7905.     store up to  20 lines with  each having up  to 128 characters,  into
  7906.     memory without giving any warnings;
  7907.  
  7908.   ■ Added command-line parameter /REMSIM  to let MTA create a  file that
  7909.     can be  TYPE'ed and  will show  the looks  of MTA  when it  displays
  7910.     messages remote. Can be used to check color-setup;
  7911.  
  7912.   ■ Added two remote lines when MTA is not used in SIMULATE mode and will
  7913.     call a child of itself. The childs (arc-in-arc files) will  not write
  7914.     remote messages (yet);
  7915.  
  7916.   ■ Added the ReplaceComment option  and the /REPLCOM toggle to  make it
  7917.     possible  to  overrule  existing  comments  in FILES.BBS alike files
  7918.     with the comment from a comment-file (like FILE_ID.DIZ);
  7919.  
  7920.   ■ Changed  /C  into /TOUCHC, /F into  /TOUCHF, /L into /TOUCHL  and /H
  7921.     into /TOUCHH for compatibility reasons;
  7922.  
  7923.   ■ Added  a new  parameter to  TouchCur (and  the /TOUCHC  command-line
  7924.     switch) to touch files with the current date PLUS a supplied  number
  7925.     of days;
  7926.  
  7927.   ■ Enhanced  the  DelOldFiles  option  so  it can work with a  relative
  7928.     number  of  days.  The  old  format  (with  a  fixed  date) is still
  7929.     possible;
  7930.  
  7931.   ■ Added VIRUSMASK option to make it possible for MTA to only call  the
  7932.     virus-scanners when matching files (extensions) are found;
  7933.  
  7934.   ■ Added ALTMTATEMPPath to make it possible for MTA to convert  smaller
  7935.     archives on a RAM-disk (or fast drive) and to swap to another  drive
  7936.     if there is not enough room on the RAM-disk (or fast drive);
  7937.  
  7938.   ■ Added WEEKEXTENSION  option to make  it possible to  convert special
  7939.     BBS-extensions (A10, J23) in a  special way (f.i. from A20  which is
  7940.     an ARC file to Z20, which is ZIP);
  7941.  
  7942.   ■ Added NOSUBSTTEST option for special environments like networks;
  7943.  
  7944.   ■ Added %NP and  %NF macros for the  SubstOn and SubstOff options.  To
  7945.     be used for networks;
  7946.  
  7947.   ■  All  toggles  (/STOSIZ,  /STOCOM  and  /STONAM excluded) can now be
  7948.     coded in two  ways. The new  format allows to  use the /command+  or
  7949.     /command- syntax to switch options on (+) or off (-);
  7950.  
  7951.   ■ Revamped the overlayed version. It will now run somewhat faster  and
  7952.     still uses  around the  same amount  of memory.  Also added  a large
  7953.     number of  envrionment variables  for the  overlay mechanism  so the
  7954.     user can change the overlay mechanism to suit her/his own needs;
  7955.  
  7956.   ■ On  general  request,  all   new,  changed  and  deleted options  in
  7957.     MTA.CTL can now  be found in  a  special  file MTA__xxx.CTL (xxx  is
  7958.     the version for which  this file is meant).  In the next releases  I
  7959.     will keep  some of  the older  MTA__xxx.CTL files,  so when you skip
  7960.     from  version  15.20  to  15.50  you  can still use all MTA__xxx.CTL
  7961.     files that were created in-between and you are still able to  update
  7962.     your own MTA.CTL in an easy way !
  7963.  
  7964.  
  7965.  ┌───────┬────────────────────────────┐
  7966.  │ 15.21 │ Bug release                │
  7967.  └───────┴────────────────────────────┘
  7968.   ■ Some  new  routines  caused a number of cosmetic bugs. These are now
  7969.     fixed (registered users!!!). Also registered users should unpack the
  7970.     supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
  7971.     run the MTAREG.EXE file once;
  7972.  
  7973.   ■ Fixed a problem in the documentation. VirusMasks was actually called
  7974.     VirusMask (in  the  DOC  and  the example MTA.CTL). This must be the
  7975.     VirusMasks option (with an extra 's' at the end);
  7976.  
  7977.   ■ Fixed a problem in the  documentation. In the FilesBBSFormat option,
  7978.     the example  showed an  incorrect  syntax for I(tem) numbers. If you
  7979.     want to select the 4th item, I4 must be used and not 4I;
  7980.  
  7981.   ■ Fixed a problem  when  a user did not use the MTATempPath option. It
  7982.     is highly  recommended that  you use this option, but if you didn't,
  7983.     MTA 15.20  would  trash  the screen  and  ignore  ALL archives. This
  7984.     problem is fixed (and you can still run MTA without the option);
  7985.  
  7986.   ■ Added coding for the new SQZ 1.08.2. 1.08.1 is still supported but
  7987.     1.08.2 files can only be converted by MTA 15.21;
  7988.  
  7989.   ■ The needed memory for SQZ is released to a normal amount, also the
  7990.     earlier problem with SQZ's temporary file is removed (fixed in the
  7991.     new SQZ release);
  7992.  
  7993.   ■ Added coding to add comments to SQZ files (CarryComment and the
  7994.     AutoDescription option). At this moment, MTA is unable to obtain
  7995.     existing comments from SQZ files;
  7996.  
  7997.   ■ Added ReportInvalidFiles option to test filesnames inside archives
  7998.     agains DOS-device names;
  7999.  
  8000.  
  8001.  ┌───────┬────────────────────────────┐
  8002.  │ 15.30 │ Major release              │
  8003.  └───────┴────────────────────────────┘
  8004.   ■ Fixed a bug where MTA 15.20 and 15.21 would  not recognize ZOO files
  8005.     in the correct way;
  8006.  
  8007.   ■ Cleaned the archive detection  for some archive types. Could  result
  8008.     in strange files (16meg) to be converted;
  8009.  
  8010.   ■ Fixed a bug in recursive ARC/HYP usage. This could result in invalid
  8011.     actions (under rare conditions);
  8012.  
  8013.   ■ Fixed a bug in extended testing. This  would  occur  when files with
  8014.     special attributes were extracted from the archive;
  8015.  
  8016.   ■ Fixed a bug where MTA 15.02 and up would go wild when files with the
  8017.     READONLY, HIDDEN and/or SYSTEM attribute were inside any archive;
  8018.  
  8019.   ■ Fixed a bug where  /ATL WAS used in the primary MTA but any child of
  8020.     MTA (arc-in-arc) would not notice the /ALT option;
  8021.  
  8022.   ■ Fixed a  bug  in the CARRYCOMMENT logic (type 2). Comments would not
  8023.     be taken from  FILES.BBS  and  would result in wrong descriptions in
  8024.     the new archive (double headers and so on);
  8025.  
  8026.   ■ Fixed a bug in the ReportInvalidFiles option. 'Device files' with an
  8027.     extension did not match  but  DOS still allows them as deviced. This
  8028.     is now fixed. The extension is stripped before the test;
  8029.  
  8030.   ■ Under rare conditions, MTA would leave the *.MTA file in the working
  8031.     directory (most noticeable with MTA /?). This is fixed;
  8032.  
  8033.   ■ Under some  multi-tasking  programs  and on some 80486 machines, MTA
  8034.     would countdown to slow or to fast. Fixed;
  8035.  
  8036.   ■ Touching of GIF files still didn't work. This is  now fixed forever;
  8037.  
  8038.   ■ The calling sequence of PKZIP would not allow the compress of any
  8039.     READONLY file. This is fixed;
  8040.  
  8041.   ■ One archive program (for the risk  of  getting  boring,  again it is
  8042.     another  'as designed'  feature  which  can not be overruled in this
  8043.     program) will  not  allow  READONLY/HIDDEN/SYSTEM files  to be moved
  8044.     into the target archive. This is fixed with a special trap;
  8045.  
  8046.   ■ The documentation (15.21 and lower) would suggest that the SHAREWAIT
  8047.     option could be used  without a  parameter. In fact it was marked as
  8048.     an error. MTA will now ignore the  SHAREWAIT parameter when there is
  8049.     no parameter coded;
  8050.  
  8051.   ■ Some  items  in the log-file (mostly errors) could not be related to
  8052.     any file. This is fixed;
  8053.  
  8054.   ■ Fixed a bug where MTA would truncate  files-counters in an incorrect
  8055.     manner. '[00]' would be stripped but '[  ]'  wouldn't where [ovrlay]
  8056.     would be stripped again (where it should stay  inside the comment);
  8057.  
  8058.   ■ Fixed a problem  where  MTA  would go crazy if you used TAB's in the
  8059.     MTA.CTL file. Only spaces  were  allowed but MTA will now also deTAB
  8060.     any TAB-character;
  8061.  
  8062.   ■ Fixed a problem  with AV'ed files where the AV bit was set but no AV
  8063.     code was present in the archive. Pervious versions of MTA would keep
  8064.     the AV code  (without  looking  at  the Include/ExcludeAVFile), this
  8065.     version will drop the AV code;
  8066.  
  8067.   ■ Fixed a problem  with ZIP files and the AUTODESCRIPTION option. This
  8068.     could result  in  help-screens and questions from the target archive
  8069.     program;
  8070.  
  8071.   ■ Enhanced the REPROTSPECIALATTRIBUTES option, so MTA can either reset
  8072.     the  attributes  to  normal (no extra parameter) or skip the archive
  8073.     (SKIP parameter coded);
  8074.  
  8075.   ■ Enhanced the VIRUSSCANNER option. There  is now a new parameter that
  8076.     must contain a short description  of the type of scanner. It will be
  8077.     displayed in the MTA log-file and  remote, when MTA is running under
  8078.     FileDoor <tm> (or  alike  programs). You  MUST CONVERT THESE OPTIONS
  8079.     IF YOU UPGRADE FROM A PREVIOUS VERSION !
  8080.  
  8081.   ■ Added  the  FIXEDCONVERSION option  to force  one or more files to a
  8082.     fixed target-system,  independent   of   the  current  target-system
  8083.     setting. Also added the /NFC  command-line  parameter to toggle this
  8084.     option off;
  8085.  
  8086.   ■ Added  the  FILESCOUNTER  option  to tell MTA which type of counters
  8087.     (if any) are used in your FILES.BBS-alike files;
  8088.  
  8089.   ■ Added the UpdateMSGFiles  option which will convert archive names in
  8090.     netmail  messages  (TICK/FES  support) much  faster (compared to the
  8091.     UpdateUntypedFiles option) when there are a large number of messages
  8092.     to be processed;
  8093.  
  8094.   ■ Added the UpdateMSGFull  and UpdateUntypedFull options. When present,
  8095.     MTA will check both  filename  AND directoryname for a match, BEFORE
  8096.     any updating is done on the untyped or MGS file;
  8097.  
  8098.   ■ Added the LeadingSpace  option  to convert comments from FILE_ID.DIZ  t,
  8099.     (and alike)  files  to a  format  that can be used by some FILES.BBS
  8100.     list-programs;
  8101.  
  8102.   ■ The virus-check programs will now be recorded in the MTA.LOG as well
  8103.     as the resulting errorlevel. You can now check WHICH virus-checker
  8104.     marked the file as infected. On the remote side, the user can that
  8105.     various virus-checkers are called;
  8106.  
  8107.   ■ Added the ExcludeAVFile option to  make the selection of archives of
  8108.     AV's must be kept more  easy. Also  bogus AV-codes can now result in
  8109.     removal of files or placement in the error-directory;
  8110.  
  8111.   ■ Added the ExcludeFriendlyMark to make it possible to skip files from
  8112.     BBS's who  use marking and already have done to the archive what you
  8113.     would normally do yourself;
  8114.  
  8115.   ■ Added  SkipNewfiles  option  to tell MTA not to touch files before a
  8116.     certain number of days have passed);
  8117.  
  8118.   ■ Added the /NUU,  /NUM,  /NUT  and  /NUF  command-line  parameters to
  8119.     toggle the  UpdateUntypedFiles,  UpdateMSGFiles,  UpdateTICKFiles or
  8120.     UpdateFESFiles to off;
  8121.  
  8122.   ■ You can  now  code  the  optional  parameter  SUB on the EXCLUDEFILE
  8123.     option to let MTA  also  delete all matched files in sub-directories
  8124.     of the archive;
  8125.  
  8126.   ■ Added the  DefFilesBBSDesc  option to change the default description
  8127.     for new files  and  files  without  any comment. Descriptions can be
  8128.     different, based on the filename;
  8129.  
  8130.   ■ Added the LogThreshold option to let MTA return an errorlevel 100 or
  8131.     116 when the log-file has grown above a certain threshold;
  8132.  
  8133.   ■ Added  the /NOOWNMARK  command-line  parameter that can be used when
  8134.     MTA is running  under  FileDoor <tm>. It  will remove any (uploaded)
  8135.     file that has your  own mark-string at the end (obvious the file was
  8136.     obtained from your BBS and will be a duplicate with a bogus name);
  8137.  
  8138.   ■ If AddFILESBBS  is  on, MTA  will  also  try to find comments in any
  8139.     DESCRIPT.ION (4Dos <tm>) comment  files  or ????????.I?? files which
  8140.     come from FileDoor <tm>;
  8141.  
  8142.   ■ Added the MakeArc  and MakeArcExclude options to convert non-archive
  8143.     files  into  archives  when  MTA is converting other archives in the
  8144.     same run. /NMA(-) and /NME(-) can  be  used  to swith either or both
  8145.     the MakeArc and MakeArcExclude option to off;
  8146.  
  8147.   ■ Added an  example  of the  calls for the virus scanner F-PROT.EXE in
  8148.     the example for MTA.CTL;
  8149.  
  8150.   ■ Added a  default  configuration file (MTA_EASY.CTL) that can be used
  8151.     as a starting point for non-BBS usage of MTA;
  8152.  
  8153.   ■ Changed the SUBST.TEC file;
  8154.  
  8155.   ■ Changed the COMMENTS.TEC file;
  8156.  
  8157.   ■ Added the ATTRIBUT.TEC file;
  8158.  
  8159.  
  8160.  MTA is tested with PKWare PKPAK version 3.61, PKWare ZIP version  1.10,
  8161.  PKWare ZIP version  1.93a, NoGate PAK  version 2.51, ARC  version 6.02,
  8162.  ZOO version 2.10,  DWC version 5.10,  LHarc version 1.13c/d/2.13,  LARC
  8163.  version 3.33, MDCD  version 1.0, ARJ version 2.39a, SQZ version 1.08.2,
  8164.  HYPER  version  25,  PKLITE  release  1.13,  GIFLITE version 1.41, JPEG
  8165.  version 1.5 and GIFTEST version 4.0ß;
  8166.  
  8167.  
  8168.  5.4 Copyright, Trademarks
  8169.  ───────────────────────────────────────────────────────────────────────
  8170.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  8171.  PKLITE        is a trademark of PKWare Inc.
  8172.  SQZ           is a trademark of Jonas I Hammarberg.
  8173.  PAK           is a trademark of NoGate Consulting.
  8174.  ARC and XARC  are trademarks of SEA inc.
  8175.  ZOO           is a trademark of R. Dhesi.
  8176.  DWC           is a trademark of Dean W. Cooper
  8177.  LZH and LHarc are trademarks of Yoshi;
  8178.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  8179.  MD            is a trademark of Michael Davenport
  8180.  ARJ           is a trademark of Robert K. Jung
  8181.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  8182.  CRA           is a trademark of DISP and donated to public domain
  8183.  DesqView      is a trademark of Quarterdeck inc.
  8184.  Windows       is a trademark of The Microsoft Corporation
  8185.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  8186.  FrontDoor     is a trademark of J. Homrichhausen
  8187.  SCAN          is a trademark of McAfee Associates
  8188.  TBScan        is a trademark of Frans Veldman / ESaSS B.V.
  8189.  HTScan        is a trademark of Harry Thijssen
  8190.  VIRX          is a trademark of Microcom Software Division
  8191.  CPAV          is a trademark of Central Point Software
  8192.  FINDVIRU      is a trademark of S&S International
  8193.  Dr. Solomon   is a trademark of S&S International
  8194.  Gobbler       is a trademark of COMRAC
  8195. │F-PROT        is a trademark of Fridrik Skulason
  8196.  VALIDATE      is a trademark of McAfee Associates
  8197.  QuickBBS      is a trademark of Pegasus Software
  8198.  Remote Access is a trademark of Continental Software
  8199.  TICK          is a trademark of Berry Geller
  8200.  FES           is a trademark of Frank Ploenissen
  8201.  GIFLITE       is a trademark of Tsung Hu
  8202.  JPEG          is a trademark of Handmade Software Inc.
  8203.  GIFTEST       is a trademark of Dave Navarro Jr.
  8204.  OS/2          is a trademark of International Business Machines (IBM)
  8205.  PC-DOS        is a trademark of International Business Machines (IBM)
  8206.  FileDoor      is a trademark of Robert W. van Hoeven
  8207.  
  8208.  MTA is written  in Turbo Pascal  6.0, with help  of the Turbo  Debugger
  8209.  2.5 and  makes extensive  use of  Object Professional  1.14 and OPCFI V
  8210.  16.03.    Some  routines   are  obtained   from  TurboPower's    Asynch
  8211.  Professional  1.04.   Both  STRG  and  SYS  (6.1  and  6.0a, commercial
  8212.  version) are included. Sources are edited with BRIEF 3.1;
  8213.  
  8214.  Turbo Pascal        is a trademark  of Borland International
  8215.  Turbo Debugger      is a trademark  of Borland International
  8216.  Object Professional is a trademark  of TurboPower Inc.
  8217.  Asynch Professional is a trademark  of TurboPower Inc.
  8218.  OPCFI               is a trademark  of Robert W. van Hoeven
  8219.  STRG and SYS        are  trademarks of Eagle Performance Software
  8220.  BRIEF               is a trademark  SolutionSystem
  8221.  
  8222.  [======================== END OF DOCUMENT ============================]
  8223.